PHPList

Extension name : '''phpList'''

Allows for subscribing a user to your instalment of PHPList. ( [https://www.phplist.org/ https://www.phplist.org] )

PHPList needs a name and an email address as a bare minimum, so a form should provide that information.

All the other configuration settings can be done inside the PostHandler PHP file. ( <code>FlexForm/src/Modules/Handlers/phpList/PostHandler.php</code> )

<syntaxhighlight lang="php">
// Let subscriber receive email in HTML format
HTML = 1;

// Full url to where you have installed PHPList e.g. https://example.com/list
PHP_LIST_URL = '';

// Name of the form field holding the email of the subscriber
FIELD_EMAIL = 'email';

// Name of the form field holding the name of the subscriber
FIELD_NAME = 'name'; 

// Name of a form field where its value holds the name of another form field holding the email of the subscriber
FIELD_AS_EMAIL = 'useFieldAsEmail'; 

// Name of a form field where its value holds the name of another form field holding the name of the subscriber
FIELD_AS_NAME = 'useFieldAsName'; 

// If the form holds no information on what list to subscribe to, then subscribe the user to the following lists by default.
DEFAULT_LISTS = [

   3 => 'signup',

   4 => 'signup',

   5 => 'signup',

   6 => 'signup',

   7 => 'signup',

   8 => 'signup'

];
</syntaxhighlight>

'''Note''': We will be updating the use of extensions in the next release, so when updating you will not lose your custom settings.

Update for FlexForm v2.1.1

All settings have been taken from the PostHandler.php file. FlexForm extension handler class has been updated to include config settings from the localsettings. See [[DevOps:Doc/FlexForm/2.1/Extensions]].

The settings now need to be setup in your localsettings. Example :
<syntaxhighlight lang="php">

// Let subscriber receive email in HTML format
$wgFlexFormConfig['extensions']['phpList']['HTML'] = 1;

// Full url to where you have installed PHPList e.g. https://example.com/list
$wgFlexFormConfig['extensions']['phpList']['PHP_LIST_URL'] = '';

// Name of the form field holding the email of the subscriber
$wgFlexFormConfig['extensions']['phpList']['FIELD_EMAIL'] = 'email';

// Name of the form field holding the name of the subscriber
$wgFlexFormConfig['extensions']['phpList']['FIELD_NAME'] = 'name';

// Name of a form field where its value holds the name of another form field holding the email of the subscriber
$wgFlexFormConfig['extensions']['phpList']['FIELD_AS_EMAIL'] = 'useThisFieldAsEmail';

// Name of a form field where its value holds the name of another form field holding the name of the subscriber
$wgFlexFormConfig['extensions']['phpList']['FIELD_AS_NAME'] = 'useThisFieldAsName';

// If the form holds no information on what list to subscribe to, then subscribe the user to the following lists by default.
$wgFlexFormConfig['extensions']['phpList']['DEFAULT_LISTS'] = [
	3 => 'signup',
	4 => 'signup',
	5 => 'signup',
	6 => 'signup',
	7 => 'signup',
	8 => 'signup'
];
</syntaxhighlight>