Email processing - Revision history

Rcollman: /* Moodle configuration */ spam tip

2008-05-22T14:22:15Z

Moodle configuration: spam tip

← Older revision		Revision as of 14:22, 22 May 2008
Line 11:		Line 11:

	== Moodle configuration ==		== Moodle configuration ==
			===Php default email settings===
			Unix and some other platforms might use a default php email program. The email program may use the config.php file to set the from line on all outgoing mail. Spam filters will not appreciate an email from an IP address and send it to the spam folder. Change the %CFG->wwwroot to the registered DNS address. For example:

			<nowiki>$CFG->wwwroot ='http://192.168.0.1/Moodle' ;</nowiki>
			should be changed to:

			<nowiki>$CFG->wwwroot ='http://www.mydomain.org/Moodle' ;</nowiki>


			===Enable bounce handling===
	Edit config.php to enable bounce handling, and setup Moodle to match your MTA configuration. Here's how. Uncomment these lines in config.php (if you cannot find them, copy them from config-dist.php):		Edit config.php to enable bounce handling, and setup Moodle to match your MTA configuration. Here's how. Uncomment these lines in config.php (if you cannot find them, copy them from config-dist.php):

Rcollman: /* Features */ changed now (2005?), please check new short intro

2008-05-20T10:50:50Z

Features: changed now (2005?), please check new short intro

← Older revision		Revision as of 10:50, 20 May 2008
Line 1:		Line 1:
	== Features ==		== Features ==
			Moodle uses SMTP protocol for email and a technique known as Variable Envelope Return Path (VERP).
	Moodle ~~now makes better use of the~~ SMTP protocol and ~~email in general. Most of the benefits result from using~~ a technique known as Variable Envelope Return Path (VERP).

	* Works on most modern MTAs (at least on Unix systems).		* Works on most modern MTAs (at least on Unix systems).
Line 9:		Line 8:
	* noreply@host has an autorresponder		* noreply@host has an autorresponder
	* Makes it easy for modules to send emails with a signed VERP reply-to.		* Makes it easy for modules to send emails with a signed VERP reply-to.
	* Handles ~~receving~~ of VERP replies: Validates the HMAC-MD5-8 signature and Dispatches the encoded request data to the relevant module		* Handles receiving of VERP replies: Validates the HMAC-MD5-8 signature and Dispatches the encoded request data to the relevant module

	== Moodle configuration ==		== Moodle configuration ==

Poltawski: /* Moodle configuration */

2008-04-05T16:02:20Z

Moodle configuration

← Older revision		Revision as of 16:02, 5 April 2008
Line 23:		Line 23:
	// for a given user, his/her email is marked bad		// for a given user, his/her email is marked bad
	$CFG->bounceratio = .20;		$CFG->bounceratio = .20;
	// Prefix to identify your site MUST BE EXACTLY 4 characters		// Prefix to identify your site MUST BE EXACTLY 3 characters
	$CFG->mailprefix = '~~mdl1~~';		$CFG->mailprefix = 'mdl';
	// Domain which acccepts email for processing		// Domain which acccepts email for processing
	$CFG->maildomain = 'bounces.my.domain';		$CFG->maildomain = 'bounces.my.domain';

Poltawski: added exim configuration option for keeping case in local part

2008-04-05T15:20:03Z

added exim configuration option for keeping case in local part

← Older revision		Revision as of 15:20, 5 April 2008
Line 86:		Line 86:
	If you are using virtualdomains, consult your server administrator for the correct configuration. It probably involves editing transports and mapping your address to a "pipe" transport.		If you are using virtualdomains, consult your server administrator for the correct configuration. It probably involves editing transports and mapping your address to a "pipe" transport.

	More documentation about Exim can be found [http://www.exim.org/docs.html here]. You ~~may~~ have to tell Exim not to lowercase the local-part.		More documentation about Exim can be found [http://www.exim.org/docs.html here].

			You will probably have to tell Exim not to lowercase the local-part in your exim configuration. This can be done in the router which handles the mail for your aliases file with:
			caseful_local_part = true

	== Developer info ==		== Developer info ==

Poltawski: put example config options for malprefix/domain

2008-04-05T15:04:40Z

put example config options for malprefix/domain

← Older revision		Revision as of 15:04, 5 April 2008
Line 23:		Line 23:
	// for a given user, his/her email is marked bad		// for a given user, his/her email is marked bad
	$CFG->bounceratio = .20;		$CFG->bounceratio = .20;
			// Prefix to identify your site MUST BE EXACTLY 4 characters
			$CFG->mailprefix = 'mdl1';
			// Domain which acccepts email for processing
			$CFG->maildomain = 'bounces.my.domain';

	Edit the $CFG->maildomain line and one of the $CFG->mailprefix lines (the one that matches your MTA).		Edit the $CFG->maildomain line and one of the $CFG->mailprefix lines (the one that matches your MTA).

Matm: /* Email confirmation or registration words, and how to edit them. */

2008-03-17T09:02:56Z

Email confirmation or registration words, and how to edit them.

← Older revision		Revision as of 09:02, 17 March 2008
Line 38:		Line 38:
	**<nowiki><a href="http://www.blah_blah">click here</a></nowiki> If you do this in the moodle.php file, your edited text won't appear.		**<nowiki><a href="http://www.blah_blah">click here</a></nowiki> If you do this in the moodle.php file, your edited text won't appear.
	**Use <nowiki><a href=\"http://www.blah_blah\">click here</a></nowiki>		**Use <nowiki><a href=\"http://www.blah_blah\">click here</a></nowiki>
	*Use the \ before each " when marking up things like target=\"_blank" and title=\"Blah blah\" and other similar codes.		*Use the \ before each " when marking up things like target=\"_blank\" and title=\"Blah blah\" and other similar codes.
	*If you feel you must really go the route of editing the moodle.php file directly, save a copy of the file in its own folder (copy and paste the file in the same folder). That way, if it all goes wrong for you, all you have to do is delete the botched file and rename the 'copy of moodle.php' back to 'moodle.php' and you are back to square one, no harm done!		*If you feel you must really go the route of editing the moodle.php file directly, save a copy of the file in its own folder (copy and paste the file in the same folder). That way, if it all goes wrong for you, all you have to do is delete the botched file and rename the 'copy of moodle.php' back to 'moodle.php' and you are back to square one, no harm done!
	*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.		*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.

Matm: /* Email confirmation or registration words, and how to edit them. */

2007-09-26T19:42:19Z

Email confirmation or registration words, and how to edit them.

← Older revision		Revision as of 19:42, 26 September 2007
Line 42:		Line 42:
	*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.		*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.
	[[Image:Example.jpg]]		[[Image:Example.jpg]]

	~~Make sure ''process_email.php'' is executable by running "chmod ugo+rx process_email.php".~~

	== Setup under Postfix ==		== Setup under Postfix ==

Matm: /* Email confirmation or registration words, and how to edit them. */

2007-09-26T19:31:11Z

Email confirmation or registration words, and how to edit them.

← Older revision		Revision as of 19:31, 26 September 2007
Line 41:		Line 41:
	*If you feel you must really go the route of editing the moodle.php file directly, save a copy of the file in its own folder (copy and paste the file in the same folder). That way, if it all goes wrong for you, all you have to do is delete the botched file and rename the 'copy of moodle.php' back to 'moodle.php' and you are back to square one, no harm done!		*If you feel you must really go the route of editing the moodle.php file directly, save a copy of the file in its own folder (copy and paste the file in the same folder). That way, if it all goes wrong for you, all you have to do is delete the botched file and rename the 'copy of moodle.php' back to 'moodle.php' and you are back to square one, no harm done!
	*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.		*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.
			[[Image:Example.jpg]]

	Make sure ''process_email.php'' is executable by running "chmod ugo+rx process_email.php".		Make sure ''process_email.php'' is executable by running "chmod ugo+rx process_email.php".

Matm: /* Email confirmation or registration words */

2007-09-26T19:06:11Z

Email confirmation or registration words

← Older revision		Revision as of 19:06, 26 September 2007
Line 30:		Line 30:
	Edit the process_email.php script to point to the location of your php binary. It will usually be ''/usr/bin/php''.		Edit the process_email.php script to point to the location of your php binary. It will usually be ''/usr/bin/php''.

	==Email confirmation or registration words==		==Email confirmation or registration words, and how to edit them.==
	* Students receive a confirmation email when they create a user account. This text can be found in the lang/?/moodle.php as the emailconfirmation "variable".		* Students receive a confirmation email when they create a user account. This text can be found in the lang/?/moodle.php as the emailconfirmation "variable".
	* Students receive a welcome email when they enroll in a course. This text can be found in the lang/?/moodle.php file as the welcometocoursetext "variable".		* Students receive a welcome email when they enroll in a course. This text can be found in the lang/?/moodle.php file as the welcometocoursetext "variable".

Matm: /* Email confirmation or registration words, and how to edit them. */

2007-09-26T19:05:09Z

Email confirmation or registration words, and how to edit them.

← Older revision		Revision as of 19:05, 26 September 2007
Line 41:		Line 41:
	*If you feel you must really go the route of editing the moodle.php file directly, save a copy of the file in its own folder (copy and paste the file in the same folder). That way, if it all goes wrong for you, all you have to do is delete the botched file and rename the 'copy of moodle.php' back to 'moodle.php' and you are back to square one, no harm done!		*If you feel you must really go the route of editing the moodle.php file directly, save a copy of the file in its own folder (copy and paste the file in the same folder). That way, if it all goes wrong for you, all you have to do is delete the botched file and rename the 'copy of moodle.php' back to 'moodle.php' and you are back to square one, no harm done!
	*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.		*Having said all that, it is best to do all your editing in the web interface by going to Site Administration -> Language editing, and then clicking on the string that you wish to edit.


	Make sure ''process_email.php'' is executable by running "chmod ugo+rx process_email.php".		Make sure ''process_email.php'' is executable by running "chmod ugo+rx process_email.php".