User Tools

Site Tools

Translations of this page:


All config file options

Constants and variables

#editcategorytypepurposeallowed valuesdefault
3admin_auth_moduleauthenticationvariableclass for authentication of the administratorclass
4allow_updateradminconstantEnable Automatic Updatertrue, falsetrue
5allowed_referrerssecurityvariableDomains that can refer to the phpList systemarray of domainsempty array
6attachment_repositorysystemvariableLocation where uploaded files are storedA webserver writable pathno value
7blacklist_gracetimesubscriber managementconstantNumber of minutes to allow sending a message after blacklisting a subscriberinteger5
8bounce_mailbox_purgebounce managementvariabledelete bounces from the mailbox once they have been processedtrue false 0 1true
9bounce_mailbox_purge_unprocessedbounce managementvariableDelete bounces from the mailbox that were not matched to be for a campaign or subscriber (unidentified bounce)true false 0 1true
10bounce_protocolbounce managementvariableWhat method to use to fetch bouncespop mboxpop
11bounce_unsubscribe_thresholdsubscriber managementvariableHow many consecutive bounces to consider before marking a subscriber unconfirmedInteger5
12check_for_hostsubscriber managementvariableVerify that the HOST part of an email address is a deliverable domaintrue false 0 10
13database_connection_compressiondatabasevariableUse compression in the mySql database connectiontrue falsefalse
14database_connection_ssldatabasevariableUse SSL when connecting to the databasetrue falsefalse
15database_moduledatabasevariablethe file holding the database
16default_system_languagei18nvariableLanguage to use when it cannot be determined from the contextISO code of the languageen
17export_mimetypesubscriber managementvariableThe mime-type sent to the browser for the export filea mime-typeapplication/csv
18installation_namesystemvariableName a phpList installation to be able to distinguish different installationsstringphpList
19language_modulei18nvariableThe default language for the frontendany of the files in lists/texts/
20message_envelopebounce managementvariableThe email address where bounces will goone single valid email addressno value
21noteditableconfigadminvariableSuppress certain config values from being editable in the admin pages.array of valuesempty array
22pagerootsystemvariableLocation of phpList in relation to the web server roota valid path/lists/
23phpmailer_smtpusersystemvariableSTMP Authentication usernamestringno value
24phpmailer_smtppasswordsystemvariableSMTP authentication passwordstringno value
25plugins_disabledsystemvariableDisable selected pluginsarray of plugin namesempty array
26require_loginsecurityvariableActivate the authentication system0 11
27table_prefixsystemvariableprefix for all table namesstringphplist_
28tmpdirsystemvariableLocation to place temporary files, when neededwritable path for webserver/tmp
29usertable_prefixsystemvariableprefix for subscriber related datastringphplist_user_
30access_control_allow_originsecurityconstantBlock requests from an incorrect locationhttp://'.$_SERVER['HTTP_HOST']
31add_email_throttlesecurityconstantLimit the use of the Add email in the send test functionalityAny number1
32admin_protocolconstantenforce HTTPS on admin pageshttp httpshttp
33allow_attachmentscompositionconstantChange 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
34allow_deletebouncebounce managementconstantEnable deletion of bouncestrue false 0 11
35allow_importsubscriber managementconstantEnable import functionalitytrue false 0 1true
36allow_non_list_subscribesubscriptionconstantDo not require choosing a list to subscribe totrue false 0 10
37always_add_usertrackstatisticsconstantAlways add the tracking image to campaignstrue false 0 11
38askforpasswordsecurityconstantAsk subscribers to enter a password for their profile when they registertrue false 0 10
39attributevalue_reorder_limitsegmentationconstantdisallow ordering the attribute values where there are more than this amountnumber100
40aws_accesskeyidawsconstantThe access key for using Amazon SESno value
41aws_posturlawsconstantThe URL for Amazon AWS
42aws_secretkeyawsconstantSecret key for sending with Amazon SESstringno value
43blacklist_email_on_bouncebounce managementconstantAdd an address to the blacklist when it has bounced too many timesAny number5
44block_pasted_clicktracklinkscompositionconstantDetect clicktrack links in the content and block sending the campaign if foundtrue false 0 10
45check_referrersecurityconstantVerify that the referring web page is allowedtrue false 0 11
46check_sessionipsecurityconstantVerify the session of the logged in administratortrue false 0 11
47clicktrackstatisticsconstantEnable tracking of clicks in campaigns via URL rewritingtrue false 0 11
48clicktrack_linkmapstatisticsconstantDefine a mod-rewrite mapping of clicked linksA sensible stringno value
49clicktrack_showdetailstatisticsconstantShow more detail in the statistics when tracking clickstrue false 0 10
50date_end_yearsegmentationconstantSet the end year for any date dropdownany sensible year0
51date_start_yearsegmentationconstantSet the start year for any date dropdownAny recent year1900
52db_translationi18nconstantNo ideatrue false0
53default_messageagequeue processingconstantAmount of time to allow sending a campaign, until it is considered too oldAny sensible number604800
54default_mimetypecompositionconstantFallback for the mimetype when it could not be determineda sensible mimetypeapplication/octet-stream
55devsitesystemconstantRun phpList in development modetrue falsefalse
56domain_auto_throttlequeue processingconstantAuto throttle sending to domainstrue false 0 10
57domain_batch_periodqueue processingconstantTime frame for domain throttlingAny number larger than 1120
58domain_batch_sizequeue processingconstantAmount of mails to allow being sent to the same domain in the indicated timeAny number larger than 01
59emailtextcreditsrenderingconstantUse text credits for phpList in emails, instead of an imagetrue false 0 10
60email_address_validation_levelsubscriber managementconstantA choice of level of validation of an email address0, 1, 2, 3, 43
61embedexternalimagescompositionconstantpull external images and embed them in campaignstrue falsefalse
62embeduploadimagesrenderingconstantAdd uploaded images as embedded images when sendingtrue false 0 10
63empty_value_prefixsegmentationconstantSet a dropdown prefix which indicates no valueA short string--
64encryption_algosecurityconstantThe encryption method to use when encrypting passwordsany algorithm accepted in your PHP system, see
65encrypt_admin_passwordssecurityconstantEnable encryption of admin passwordstrue false 0 11
66error404pagesystemconstantAllow a custom file-not-found pagefilename in webroot
67export_excelsubscriber managementconstantFormat the export file to allow use in Microsoft Exceltrue falsefalse
68fckimages_dircompositionconstantLocation for uploading images in the FCKeditorDirectory name in the "lists" directoryuploadimages
69filesystem_attachmentscompositionconstantAllow adding attachments from the filesystem of the server phpList is running ontrue false 0 10
70forward_alternative_contentsocial networkingconstantEnter different content for the message that is forwardedtrue false 0 1false
71forward_email_countsocial networkingconstantNumber of email addresses allowed to enter when forwarding a messageA number1
72forward_email_periodsocial networkingconstantLimit the time period for reaching the maximum forwarding amountA valid mySQL INTERVAL value1 day
73forward_personal_note_sizesocial networkingconstantAllow a personal note to be added when forwarding a messageA number (size in bytes)0 (disable)
74hash_algosecurityconstantThe hash method to use when hashing passwordsany algorithm accepted in your PHP system, see
75htmlemail_encodingrenderingconstantSet the transfer encoding for the HTML part of the generated messages8bit 7bit base64 quoted-printablequoted-printable
76import_filesizesubscriber managementconstantMaximum size of an import fileNumber (in MB)5
77keepforwarderattributessocial networkingconstantUse the attributes of the subscriber for placeholder when forwarding a messagetrue false 0 1false
78language_auto_updatei18nconstantAutomatically update translations when the filesystem file is newer than the last updatetrue falsetrue
79language_switchadminconstantAllow changing language using a dropdowntrue false 0 11
80mailqueue_autothrottlequeue processingconstantAutomatically slow down sending the queue to spread the batch size across the batch period.true false 1 00
81mailqueue_batch_periodqueue processingconstantThe time allowed for sending a batch.Any number3600
82mailqueue_batch_sizequeue processingconstantBatch processingA number higher or equal to 00
83mailqueue_throttlequeue processingconstantAdd a delay between messages to avoid overloading the server.Any number, even fractions0
84manually_process_bouncesbounce managementconstantProcess the bounces in the admin interfacetrue false 0 11
85manually_process_queuequeue processingconstantSend queued messages from the admin interface.true false 0 11
86maxlistsegmentationconstantThe maximum number of lists a non-superuser administrator can haveAny positive number1
87max_avatar_sizesubscriber managementconstantSize of file for avatarAny sensible number2000
88max_msg_ppconstantLimit the amount of results listed in a pagepositive number5
89max_processqueue_timequeue processingconstantLimit the time that can be used to process the queueAny number99999
90max_process_messagequeue processingconstantHow many campaigns to process at the same timeAny positive number5
91max_sendprocessesqueue processingconstantNumber of simultaneous sending processes allowed11
92max_user_ppconstantLimit the amount of results listed in a pagepositive number50
93merge_duplicates_delete_duplicatesubscriber managementconstantWhen merging duplicate subscribers, remove the duplicatetrue falsetrue
94messagequeue_preparequeue processingconstantRun the queue in a two-process waytrue false 0 10
95message_sendstatus_inactivethresholdqueue processingconstantHow soon to say a campaign being sent is "stalled" or not sendingAny number120
96message_sendstatus_sampletimequeue processingconstantThe number of second to sample for a running campaign, to calculate the send speedAny positive number600
97mimetypes_filecompositionconstantFile containing the Mime-types of binary filesstring pointing to a file with mime-types/etc/mime.types
98nostatscollectionfeedbackconstantSwitch off collection of statistics0 1 true falsefalse
99notify_spamanti-spamconstantSend an alert when spam was blockedtrue false 0 11
100numattachmentscompositionconstantHow many attachments to allow uploading in one go.Any positive number1
101pagetextcreditssubscriptionconstantUse text credits for phpList on pages, instead of an imagetrue false 0 10
102password_change_timeframesecurityconstantTime allowed for an admin to use the token to change their password.A valid mySQL INTERVAL value1 day
103phpmailersystemconstantUse phpMailer for sendingtrue false 0 11
104phpmailerblasthostqueue processingconstantSMTP server to use when sending the actual campaignThe FQDB of the serverPHPMAILERHOST
105phpmailerblastportqueue processingconstantThe port to use with PHPMAILERBLASTHOSTA working portPHPMAILERPORT
106phpmailerhostsystemconstantSMTP host for sending messagesa valid FQDN of the SMTP hostno value
107phpmailertesthostcompositionconstantThe SMTP server to use when sending a test mailthe FQDN of the SMTP serverPHPMAILERHOST
108phpmailer_securerenderingconstantSet the Secure option in phpMailerauto tls ssl falseauto
109plugin_rootdirsconstantSemi-colon separated list of directories to look for plugins.Text, pointing to the value
110preferencepage_show_private_listssegmentationconstantWhen a subscriber is viewing their preferences page, show all lists, not just the public onestrue false 0 10
111processcampaigns_parallelqueue processingconstantWhen processing multiple campaigns, send them in paralleltrue, false, 0, 1false
112public_protocolsystemconstantSet the protocol for public pages.http httpshttp
114registerfeedbackconstantLet 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
115remote_url_refetch_timeoutsystemconstantHow long to keep a remote URL in cache before fetching it againAny number greater than 03600 (one hour)
116resetstats_maxconstantdisallow resetting statistics when this value has been reachedpositive number10
117rfc_direct_deliverysubscriptionconstantDirect delivery of the request for confirmationtrue false 0 1false
118sendprocess_servernamequeue processingconstantString to identify a send processany textlocalhost
119sendtest_maxsecurityconstantLimit the number of email addresses that can be used in the send test functionalityAny number999
120sendtest_throttlesecurityconstantLimit the use of the send test functionalityAny number1
121send_listadmin_copysystemconstantSend a notification to the owner of a listtrue false 0 1false
122send_one_testmailcompositionconstantSend one test email when using the test functionalitytrue false 0 11
123show_list_ofall_subscriberssegmentationconstantOn the list and members page, show a static "list" that has all subscribers in the system as memberstrue false 1 0false
124show_pqchoicequeue processingconstantEnable remote cron processing choicetrue, false, 0, 1false (Jan 2015)
125show_unsubscribelinksubscriptionconstantShow a link to the unsubscribe page on the subscribe pagetrue falsetrue
126silent_resubscribesubscriptionconstantAllow existing subscribers to re-subscribe without throwing an error.true false 0 1true
127smtp_timeoutqueue processingconstantTimeout when sending a mail with SMTPAny number5
128stacked_attribute_selectionsegmentationconstantUse stacking of attribute segmentationtrue false 0 10
129stats_intervalstatisticsconstantNot sure
130testconstantTry the system without sending any emails.true false 0 11
131textemail_encodingrenderingconstantSet the transfer encoding for the text part of an outgoing message7bit 8bit7bit
132tinymcepathcompositionconstantno value
133tld_auth_listsystemconstantURL that returns a list of valid Top Level DomainsAny URL
134tld_auth_md5systemconstantThe MD5 of the TLD_AUTH_LISTAny URL
135tld_refetch_timeoutsystemconstantRefresh time for automatically updating the list of TLDsAny number15552000
136translations_xmli18nconstantLocation where translations can be fetched and refreshedA URL that returns a valid XML
137unblacklist_in_profilesubscriber managementconstantAdd a link to remove a subscriber from the blacklist in their profiletrue false 0 10
138unsubscribe_jumpoffsubscriptionconstantImmediately 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
139unsubscribe_requires_passwordsecurityconstantRequest a valid password before acting on unsubscribe.true false 0 1false
140uploadimages_dircompositionconstantLocation of a webserver-writable folder for storing images.Any name of a directoryimages
141useckcompositionconstantUse the CKeditor for creating campaignstrue false 0 10
142usefckcompositionconstantUse the FCKeditor for creating campaignstrue false 0 11
145use_admin_details_for_messagescompositionconstantPre-fill the From field when creating a campaign, with the details of the administrator logged intrue false 0 11
146use_advanced_bouncehandlingbounce managementconstantAllow fine grained regular expressions to determine what to do with bounced messages.true false 0 10
147use_amazonsesawsconstantDetermine whether to send with Amazon SESdo not set this value
148use_domain_throttlequeue processingconstantEnable throttling per domaintrue false 0 10
149use_editmessageconstantAllow editing a campaign0 10
150use_list_excludesegmentationconstantAllow selection of lists NOT to send a campaign totrue false 0 10
151use_local_spoolqueue processingconstantExperimental, do not use
152use_manual_text_partcompositionconstantManually enter the text version of the campaigntrue falsefalse
153use_minified_assetsconstantWhen displaying pages use the minified version of the CSS and JS files.true falsetrue
154use_pdfconstantEnable the automatic conversion to PDF functionality0 10
155use_personalised_remoteurlsrenderingconstantNot sure
156use_precedence_headerrenderingconstantUse the Precedence: header in outgoing mailstrue false 0 1true
157use_prepareconstantUse the prepare systemtrue false 0 10
158use_repetitioncompositionconstantAdd the functionality to repeat campaignstrue false 0 10
159use_spam_blockanti-spamconstantBlock spammers from signing uptrue false 0 11
160verboseconstantDisplay more information about what phpList is doing, including log entries for every email that is senttrue falsefalse
161warn_about_php_settingsconstantDisplay a warning if some PHP settings are not as desiredtrue false 0 11
162warn_savechangescompositionconstantWarn when changing page and there are unsaved changestrue false 0 11
163wordwrap_htmlrenderingconstantApply line wrapA number0
164phpmailer_smtpoptionssendingvariablepass smtpoptions to phpMailerany valid smtpoptions for phpMailer
165phpmailerportsystemconstantThe port number for the SMTP connection to PHPMAILERHOSTintegerno value
166stats_collection_addressfeedbackvariableEmail address to send the statistics report toemail
167uisystemvariableUser Interfaceany subdirectory in admin/ui/dressprow
168userspage_maxsubscriber managementconstantSuppress the listing of subscribers when there are more than this valueNumber1000
system/config/all.txt · Last modified: 2013/08/21 01:47 by phplist

Contact Us


Boring Bit

phpList is a registered limited company

UK Company No. 07582966

VAT Registration 122 0788 37

© phpList 2016