meta data for this page
  •  
Translations of this page:
editcategory purposeallowed valuesdefault
dataentryhttp
usetinymcemesg
usetinymcetempl
tinymcepathcompositionno value
email_address_validation_levelsubscriber managementA choice of level of validation of an email address0, 1, 2, 3, 43
mailqueue_throttlequeue processingAdd a delay between messages to avoid overloading the server.Any number, even fractions0
unblacklist_in_profilesubscriber managementAdd a link to remove a subscriber from the blacklist in their profiletrue false 0 10
blacklist_email_on_bouncebounce managementAdd an address to the blacklist when it has bounced too many timesAny number5
use_repetitioncompositionAdd the functionality to repeat campaignstrue false 0 10
embeduploadimagesrenderingAdd uploaded images as embedded images when sendingtrue false 0 10
error404pagesystemAllow a custom file-not-found pagefilename in webroot
forward_personal_note_sizesocial networkingAllow a personal note to be added when forwarding a messageA number (size in bytes)0 (disable)
filesystem_attachmentscompositionAllow adding attachments from the filesystem of the server phpList is running ontrue false 0 10
language_switchadminAllow changing language using a dropdowntrue false 0 11
use_editmessageAllow editing a campaign0 10
silent_resubscribesubscriptionAllow existing subscribers to re-subscribe without throwing an error.true false 0 1true
use_advanced_bouncehandlingbounce managementAllow fine grained regular expressions to determine what to do with bounced messages.true false 0 10
use_list_excludesegmentationAllow selection of lists NOT to send a campaign totrue false 0 10
always_add_usertrackstatisticsAlways add the tracking image to campaignstrue false 0 11
domain_batch_sizequeue processingAmount of mails to allow being sent to the same domain in the indicated timeAny number larger than 01
default_messageagequeue processingAmount of time to allow sending a campaign, until it is considered too oldAny sensible number604800
wordwrap_htmlrenderingApply line wrapA number0
askforpasswordsecurityAsk subscribers to enter a password for their profile when they registertrue false 0 10
domain_auto_throttlequeue processingAuto throttle sending to domainstrue false 0 10
mailqueue_autothrottlequeue processingAutomatically slow down sending the queue to spread the batch size across the batch period.true false 1 00
language_auto_updatei18nAutomatically update translations when the filesystem file is newer than the last updatetrue falsetrue
mailqueue_batch_sizequeue processingBatch processingA number higher or equal to 00
access_control_allow_originsecurityBlock requests from an incorrect locationhttp://'.$_SERVER['HTTP_HOST']
access_control_allow_originssecurityBlock requests from an incorrect location, but allow multiple domainsarray of domainsundefined
use_spam_blockanti-spamBlock spammers from signing uptrue false 0 11
allow_attachmentscompositionChange ALLOW_ATTACHMENTS from 0 to 1 to turn on attachment support. You'll note on the send a message page that there's an additional tab labeled Attach. Click on this tab while preparing your message to add attachments. The attachment tab will display the current (server-set) size limits and allow you to browse for new files to attach. Attachments on text format messages are accessed via a URL included at the bottom of the message. Since phpList 3.4.2 those links will open attachements directly from the browser.0 1 true false0
clicktrack_linkmapstatisticsDefine a mod-rewrite mapping of clicked linksA sensible stringno value
block_pasted_clicktracklinkscompositionDetect clicktrack links in the content and block sending the campaign if foundtrue false 0 10
use_amazonsesawsDetermine whether to send with Amazon SESdo not set this value
rfc_direct_deliverysubscriptionDirect delivery of the request for confirmationtrue false 0 1false
warn_about_php_settingsDisplay a warning if some PHP settings are not as desiredtrue false 0 11
verboseDisplay more information about what phpList is doing, including log entries for every email that is senttrue falsefalse
allow_non_list_subscribesubscriptionDo not require choosing a list to subscribe totrue false 0 10
allow_updateradminEnable Automatic Updatertrue, falsetrue
allow_deletebouncebounce managementEnable deletion of bouncestrue false 0 11
encrypt_admin_passwordssecurityEnable encryption of admin passwordstrue false 0 11
allow_importsubscriber managementEnable import functionalitytrue false 0 1true
show_pqchoicequeue processingEnable remote cron processing choicetrue, false, 0, 1false (Jan 2015)
use_pdfEnable the automatic conversion to PDF functionality0 10
use_domain_throttlequeue processingEnable throttling per domaintrue false 0 10
clicktrackstatisticsEnable tracking of clicks in campaigns via URL rewritingtrue false 0 11
forward_alternative_contentsocial networkingEnter different content for the message that is forwardedtrue false 0 1false
use_local_spoolqueue processingExperimental, do not use
default_mimetypecompositionFallback for the mimetype when it could not be determineda sensible mimetypeapplication/octet-stream
mimetypes_filecompositionFile containing the Mime-types of binary filesstring pointing to a file with mime-types/etc/mime.types
export_excelsubscriber managementFormat the export file to allow use in Microsoft Exceltrue falsefalse
remote_url_refetch_timeoutsystemHow long to keep a remote URL in cache before fetching it againAny number greater than 03600 (one hour)
numattachmentscompositionHow many attachments to allow uploading in one go.Any positive number1
max_process_messagequeue processingHow many campaigns to process at the same timeAny positive number5
message_sendstatus_inactivethresholdqueue processingHow soon to say a campaign being sent is "stalled" or not sendingAny number120
unsubscribe_jumpoffsubscriptionImmediately unsubscribe someone when they click the Unsubscribe link in an email message they received, without asking them first why they are unsubscribing.true false 1 0false
registerfeedbackLet the phpList developers get a little bit of feedback on the use of phpList by retrieving the "Powered By" image from the phpList websitetrue false 0 11
max_user_ppLimit the amount of results listed in a pagepositive number50
max_msg_ppLimit the amount of results listed in a pagepositive number5
sendtest_maxsecurityLimit the number of email addresses that can be used in the send test functionalityAny number999
forward_email_periodsocial networkingLimit the time period for reaching the maximum forwarding amountA valid mySQL INTERVAL value1 day
max_processqueue_timequeue processingLimit the time that can be used to process the queueAny number99999
add_email_throttlesecurityLimit the use of the Add email in the send test functionalityAny number1
sendtest_throttlesecurityLimit the use of the send test functionalityAny number1
fckimages_dircompositionLocation for uploading images in the FCKeditorDirectory name in the "lists" directoryuploadimages
uploadimages_dircompositionLocation of a webserver-writable folder for storing images.Any name of a directoryimages
translations_xmli18nLocation where translations can be fetched and refreshedA URL that returns a valid XMLhttp://translate.phplist.com/translations.xml
use_manual_text_partcompositionManually enter the text version of the campaigntrue falsefalse
import_filesizesubscriber managementMaximum size of an import fileNumber (in MB)5
db_translationi18nNo ideatrue false0
stats_intervalstatisticsNot sure
use_personalised_remoteurlsrenderingNot sure
forward_email_countsocial networkingNumber of email addresses allowed to enter when forwarding a messageA number1
blacklist_gracetimesubscriber managementNumber of minutes to allow sending a message after blacklisting a subscriberinteger5
max_sendprocessesqueue processingNumber of simultaneous sending processes allowed11
show_list_ofall_subscriberssegmentationOn the list and members page, show a static "list" that has all subscribers in the system as memberstrue false 1 0false
use_admin_details_for_messagescompositionPre-fill the From field when creating a campaign, with the details of the administrator logged intrue false 0 11
manually_process_bouncesbounce managementProcess the bounces in the admin interfacetrue false 0 11
tld_refetch_timeoutsystemRefresh time for automatically updating the list of TLDsAny number15552000
unsubscribe_requires_passwordsecurityRequest a valid password before acting on unsubscribe.true false 0 1false
devsitesystemRun phpList in development modetrue falsefalse
messagequeue_preparequeue processingRun the queue in a two-process waytrue false 0 10
phpmailerhostsystemSMTP host for sending messagesa valid FQDN of the SMTP hostno value
phpmailersubscribehostsystemSMTP host for sending messages that originate from the subscribe pagesa valid FQDN of the SMTP hostPHPMAILERHOST
phpmailerblasthostqueue processingSMTP server to use when sending the actual campaignThe FQDB of the serverPHPMAILERHOST
aws_secretkeyawsSecret key for sending with Amazon SESstringno value
plugin_rootdirsSemi-colon separated list of directories to look for plugins.Text, pointing to the directories.no value
send_listadmin_copysystemSend a notification to the owner of a listtrue false 0 1false
notify_spamanti-spamSend an alert when spam was blockedtrue false 0 11
send_one_testmailcompositionSend one test email when using the test functionalitytrue false 0 11
manually_process_queuequeue processingSend queued messages from the admin interface.true false 0 11
empty_value_prefixsegmentationSet a dropdown prefix which indicates no valueA short string--
phpmailer_securerenderingSet the Secure option in phpMailerauto tls ssl falseauto
date_end_yearsegmentationSet the end year for any date dropdownany sensible year0
public_protocolsystemSet the protocol for public pages.http httpshttp
date_start_yearsegmentationSet the start year for any date dropdownAny recent year1900
htmlemail_encodingrenderingSet the transfer encoding for the HTML part of the generated messages8bit 7bit base64 quoted-printablequoted-printable
textemail_encodingrenderingSet the transfer encoding for the text part of an outgoing message7bit 8bit7bit
show_unsubscribelinksubscriptionShow a link to the unsubscribe page on the subscribe pagetrue falsetrue
clicktrack_showdetailstatisticsShow more detail in the statistics when tracking clickstrue false 0 10