User Tools

Site Tools

Translations of this page:

system:config:all

All config file options

Constants and variables

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

Resources
Contact Us

e: info@phplist.com

Boring Bit

phpList is a registered limited company

UK Company No. 07582966

VAT Registration 122 0788 37

© phpList 2016