Ultima/code/email

#!/usr/bin/env perl

use strict;
use warnings;
use diagnostics;

use Pod::Usage;
use Getopt::Long;

use Data::Dumper;

#Command line options/flags.
my $man = 0;        #Print a manual to STDERR.
my $help = 0;       #Print a short help message to STDERR.

#Options taken by this command.
GetOptions(
            'help|h' => \$help,
            'man' => \$man,
          ) or pod2usage(2); #If we fail to parse the options output a usage message.

pod2usage(1) if $help;
pod2usage(-verbose => 2) if $man;

#Foreach member of staff from the input file
foreach (<>) {	
	my @fields = qw/nid uid firstname surname password email username/;
	my @data = split ' ', $_;
	my %record;
	@record{ @fields } = @data;
	my $email = <<"EMAIL";
Dear $record{'firstname'} $record{'surname'},

As you may be aware, the IGES web site is in the process of being overhauled. The old website
(http://www.aber.ac.uk/iges/) will remain live until the new website is launched. The new website
can only be accessed currently from the campus network (or off-campus via VPN) at:
http://www.ies.aber.ac.uk/. Once it is launched publicly, both the new and old web addresses will
work. We need your help in preparing the new site for its launch. At its backbone, the new site
has a content management system, which allows registered users to author, edit and maintain their
own content (e.g. your staff pages, project pages, blogs, calendars, etc.). Every member of staff
and all postgraduates are now being provided an account and we are asking you to update the
details on your staff page. If you could do this by the 15th April 2008, it would be most
appreciated. This email provides instructions for how to complete account registration, edit your
staff page and get more help if you need it.


ACCOUNT REGISTRATION AND UPDATE:

A site administrator has created an account for you ($record{'username'}). You may now log in to
http://www.ies.aber.ac.uk using the following username and temporarily assigned password:

username: $record{'username'}
password: $record{'password'}

Your staff page can be found at: http://www.ies.aber.ac.uk/en/node/$record{'nid'}

After logging in, you should change your password. Click on 'My account' in the Navigation bar on
the left-hand side, and then click the edit tab. If you wish, you can provide additional
information linked to your account profile, like a photo, the location where you are from (this
is used to create a user-map: http://www.ies.aber.ac.uk/en/map/user) and a signature that will be
used for all forum posts and comments you post to the site. If you can't find the 'My account'
option in the menu you can alternately click here after logging in:
http://www.ies.aber.ac.uk/en/user/$record{'uid'}/edit


EDITING YOUR STAFF PAGE:

To edit your personal staff page we have created for you, click on this link after you have
logged in to the website: http://www.ies.aber.ac.uk/en/node/$record{'nid'}/edit

Once you are done editing, scroll to the bottom of the page and click 'Submit' to save changes.
Please confirm that all the information is current, and update any incorrect information or
information required in mandatory fields. You can reach the editable portion of your staff page
anytime by clicking the 'Edit' tab from the page when logged in.

You will find that there is a wealth of additional information about yourself you can choose to
provide and these will update the content on both your main staff page and a series of
automatically created child pages (e.g. Teaching, Research, Publications, Admin, Calendar). We
have attempted to populate your page already with any information we had on you and/or
information entered on the old web site. Further details can be found at:
http://www.ies.aber.ac.uk/en/subsites/site-editing-workflow/editing-my-staff-page. Please note
that your staff page may not show correctly in the staff lists until you have completed the
edits. Note that the content for the 'Further Information' sub-pages are either populated with
information from edit form for your main staff page or, automatically populated based on
information entered elsewhere on the site (e.g. modules you teach, or your publications).

In the case of those staff with publications, we have uploaded all your publications listed on
the old site, and all publications we could find in Web of Science and Google Scholar thought to
be authored by you to a publications database on this site. Please check that the publications
listed for you are correct (i.e. actually your publications and not someone else with a similar
name) and up to date. You can optionally edit any of your publications to provide more
information like DOIs, URLs, abstracts, or even downloadable attachments of the publication (see
help entry for more details:
http://www.ies.aber.ac.uk/en/subsites/site-editing-workflow/editing-biblio-entry).  You can also
choose to promote specific publications from your main staff page by using the 'Select
Publications' feature when editing your staff page. To add a new publication, see:
http://www.ies.aber.ac.uk/en/subsites/help-site-editing/add-reference-site-library


NEED MORE HELP:

If you need more help, you can:

Browse a limited number of help entries here: http://www.ies.aber.ac.uk/en/subsites/help-pages
Post a question to one of the Web Site Support forums here: http://www.ies.aber.ac.uk/en/forums/web-site-support
Contact one of the site administrators: http://www.ies.aber.ac.uk/contact (also accessible by clicking Webmaster from bottom of any page)
In addition, we will run training sessions for members of staff who are interested in learning
how to extend their web content on this site. We will slowly populate the help pages further as
questions arise and we ask people to add or update specific content. Please bear with us during
this internal testing and development period, while we work all the bugs out.


THE REST OF THE SITE:

Feel free to browse around the rest of the site, but be forewarned that there are many sections,
which are incomplete and/or under development. Some of you may be asked to help with authoring
and providing content in other areas of the site. Details will be provided to the appropriate
individuals in due course. If you find any bugs or problems, please report them to the website
development team by posting the problem to the Bugs forum:
http://www.ies.aber.ac.uk/en/forums/web-site-support/bugs. If you have ideas for content you
would like to provide or extend, please contact the web development team.


Many thanks for your help (and patience)!

IGES Website Development Team
EMAIL

	open MAIL, "| mail -s 'New IGES Website Account Details' ".$record{'email'} or die "can't fork: $!";
	local $SIG{PIPE} = sub {die "Mail pipe broken."};
		print MAIL $email;
	close MAIL or die "Email failed: $! $?";
}

__END__

=head1 NAME

email_users.pl - Make batch email to the IGES Drupal users at www.ies.aber.ac.uk

=head1 SYNOPSIS

email_users.pl [options] <User records>

 Options:
   -help            Print a brief usage message.
   -man             Print full documentation.

=head1 OPTIONS

=over 8

=item B<-h, --help>

Print a brief help message and exits.

=item B<--man>

Prints the manual page and exits.

=back

=head1 DESCRIPTION

B<This program> will email all users from a record file given by B<iges_users.pl>

=cut