larger smaller normal text version of this page
phplist Documentation » Configuration functions »


Configure phplist


The configuration page allows you to configure the default settings for your system. These include the domain name and system email address, default subscribe page system messages, default header/footer, etc.

A list of all you can do from the configuration page can be found at ConfigurePHPlist.

Keep in mind that newly created subscribe pages will take their initial content from the defaults set in the configuration page. Customization of individual subscribe pages and system messages can be achieved by creating or editing new subscribe pages.

Customization of some of the text strings used in public pages - like the "subscribe page", "confirmation page" and "thank you page" can be achieved by editing the .inc language file you use (e.g. lists/text/english.inc).

Other configuration options can be changed by editing the configuration file lists/config/config.php.

The following is the sample configuration used for the phplist online demo.


Default System information


Website address
Enter your your site's web address without the http:// part, e.g. www.domain.com or subdomain.domain.com. phplist will use this setting to generate URLs for internal referrals.

# edit Website address (without http://)
demo.phplist.com



Domain name
Enter the domain name of your server for use in emails, like for instance domain.com.

# edit Domain Name of your server (for email)
demo.phplist.com



Person in charge of this system
This will usually be the email address of a superadmin or webmaster. Notifications of PhpListConcepts' double opt-in (subscriptions and hopefully subscription confirmations), single opt-out (unsubscriptions), changes in user preferences, etc. will be sent to this email address, along with the addresses defined in People to CC in system emails setting.

# edit Person in charge of this system (one email address)
webmaster@demo.phplist.com



Check for updates
Enter the number of days phplist should wait before checking for a new release. If an updated version is found, you will be notified when you login in the administators module (aka, "backend"). Note: you will have to manually download and install any new phplist version.

# edit How often do you want to check for a new version of phplist (days)
7



People to CC in system emails
Enter the email address of people - usually other admins - that should receive copies of email notifications of subscriptions, subscription confirmations, changes in user preferences, etc. sent to the "person in charge of the system".

# edit List of people to CC in system emails (separate by commas)



Recipients of phplist reports
Enter the email addresses that should receive the reports phplist will generate when processing the message queue, bounces, etc.

# edit Who gets the reports (email address, separate multiple emails with a comma)
listreports@demo.phplist.com



From email address for system messages
Here you can define the email address that is displayed as the sender of system emails. The name displayed in the From field should be configured in the next setting.

# edit From email address for system messages
noreply@demo.phplist.com



From name for system messages
Enter the name of the person, company or organization that will appear in the From field of system messages. If this field is left empty, only the email address defined in "From email address for system messages" will be displayed in the From: field.

# edit What name do system messages appear to come from
Webmaster



Reply-to email address for system messages
Enter the Reply-to email address that should be used when recipients reply to system messages.

# edit Reply-to email address for system messages
noreply@demo.phplist.com



Default system messages / subscribe pages

You can use certain Placeholders in your system messages. Placeholders look like [SOMETEXT], where SOMETEXT can be different.

Some useful placeholders are:
  • [WEBSITE] - the address you type for your website
  • [DOMAIN] - the text you type for your domain
  • [SUBSCRIBEURL] - the location of the subscribe page
  • [UNSUBSCRIBEURL] - the location of the unsubscribe page
  • [PREFERENCESURL] - the location of the page where users can update their details
  • [CONFIRMATIONURL] - the location of the page where users have to confirm their subscription


Display subscribe form automatically if only one active list is offered
Normally -if you offer several lists (newsletters)- phplist will display a listing of newsletters, so the user can choose a list he wants to subscribe to, and than be transferred to the subscribe page containing the subscription form. However, when you offer only one list, you can determine whether phplist should directly display the subscribe form for that list, instead of first displaying a listing of just one list.

# edit if there is only one visible list, should it be hidden in the page
# and automatically subscribe users who sign up (0/1)
true


Width of textline form fields

# edit width of a textline field (numerical)
40



Size of textarea form fields

# edit dimensions of a textarea field (rows,columns)
10,40


Does the admin get copies of subscribe, update and unsubscribe messages

# edit Does the admin get copies of subscribe, update and unsubscribe messages (0/1)
false


Default subscribe page when there are multiple
If you have several subscribe pages, you can determine which one should be the default by entering it's ID number here.

# edit The default subscribe page when there are multiple
1



Default HTML template to use when sending a message
If you have several HTML templates, you can define which one should be the default by entering the template ID number here.

# edit The default HTML template to use when sending a message
0


Default URLs where users can (un)subscribe / perform updates, etc.

# edit URL where users can subscribe
http://demo.phplist.com/lists/?p=subscribe

# edit URL where users can unsubscribe
http://demo.phplist.com/lists/?p=unsubscribe

# edit URL where users have to confirm their subscription
http://demo.phplist.com/lists/?p=confirm

# edit URL where users can update their details
http://demo.phplist.com/lists/?p=preferences

# edit URL where messages can be forwarded
http://demo.phplist.com/lists/?p=forward


Change custom system messages when users (un)subscribe / update their details
Newly created subscribe pages will take their default settings from what you enter here. You should keep in mind that a number of these system messages -i.e., the confirmation request email and the message they receive after confirming their subscription- can be further customized for each individual subscribe page (see EditSubscribePageInfo).

# edit Subject of the message users receive when they subscribe
Request for confirmation

# edit Message users receive when they subscribe
Almost welcome to our mailinglist(s) ...
Someone, hopefully you, has subscribed your email address to the following mailinglists:
[LISTS]
If this is correct, please click this URL to confirm your subscription:
[CONFIRMATIONURL]
If this is not correct, you do not need to do anything, simply delete this message.
Thank you

# edit Subject of the message users receive when they unsubscribe
Goodbye from our Newsletter

# edit Message users receive when they unsubscribe
Goodbye from our Newsletter, sorry to see you go.
You have been unsubscribed from our newsletters.
This is the last email you will receive from us. We have added you to our
"blacklist", which means that out newsletter system will refuse to send
you any other email, without manual intervention by our administrator.
If there is an error in this information, you can re-subscribe:
please go to [PREFERENCESURL] and follow the steps.
Thank you

# edit Subject of the message users receive after confirming their email address
Welcome to our Mailinglist

# edit Message users receive after confirming their email address
Welcome to our Mailinglists
Please keep this email for later reference.
Your email address has been added to the following mailinglists:
[LISTS]
To unsubscribe please go to [UNSUBSCRIBEURL] and follow the steps.
To update your details and preferences please go to [PREFERENCESURL].
Thank you

# edit Subject of the message users receive when they have changed their details
[notify] Change of List-Membership details

# edit Message that is sent when users change their information

This message is to inform you of a change of your details on our newsletter database
You are currently member of the following newsletters:
[LISTS]
[CONFIRMATIONINFO]
The information on our system for you is as follows:
[USERDATA]
If this is not correct, please update your information at the following location:
[PREFERENCESURL]
Thank you

# edit Part of the message that is sent to their new email address when users change their information,
# and the email address has changed

When updating your details, your email address has changed.
Please confirm your new email address by visiting this webpage:
[CONFIRMATIONURL]

# edit Part of the message that is sent to their old email address when users change their information,
# and the email address has changed
Please Note: when updating your details, your email address has changed.
A message has been sent to your new email address with a URL
to confirm this change. Please visit this website to activate
your membership.

# edit Subject of message to send when users request their personal location
Your personal location

# edit Message to send when they request their personal location

You have requested your personal location to update your details from our website.
The location is below. Please make sure that you use the full line as mentioned below.
Sometimes email programme can wrap the line into multiple lines.
Your personal location is:
[PREFERENCESURL]
Thank you.



Default header/footer for messages



# edit Default footer for sending a message
--
To unsubscribe from this list visit [UNSUBSCRIBE]
To update your preferences visit [PREFERENCES]
To forward this message to someone else visit [FORWARD]



# edit Footer used when a message has been forwarded
--
This message has been forwarded to you by [FORWARDEDBY].
You have not been automatically subscribed to this newsletter.
To subscribe to this newsletter go to
[SUBSCRIBE]


HTML style for public pages

These settings apply to all public pages, e.g. the pages that display when a users subscribes, unsubscribes, or changes preferences. Newly created subscribe pages will take their default settings from what you enter here. You should keep in mind that each subscribe page can be individually customized.

Header of public pages

# edit Header of public pages. The header should start with </head> . You can add header elements,
# but don't add the title or other basic header elements.

<link href="styles/phplist.css" type="text/css" rel="stylesheet">
</head>
<body bgcolor="#ffffff" background="images/bg.png">
<a name="top"></a>
<div align=center>
<table cellspacing=0 cellpadding=0 width=710 border=0>
<tr>
<td bgcolor="#000000" rowspan=3><img height=1 alt="" src="images/transparent.png" width=1 border=0></td>
<td bgcolor="#000000"><img height=1 alt="" src="images/transparent.png" width=708 border=0></td>
<td bgcolor="#000000" rowspan=3><img height=1 alt="" src="images/transparent.png" width=1 border=0></td>
</tr>

<tr valign="top" align="left">
<td>
<!--TOP TABLE starts-->
<TABLE cellSpacing=0 cellPadding=0 width=708 bgColor=#ffffff border=0>
<TR vAlign=top>
<TD colSpan=2 rowspan="2" height="63" background="images/topstrip.png"><a href="http://www.phplist.com" target="_blank"><img src="images/masthead.png" border=0 width=577 height=75></a></TD>
<TD align=left
background="images/topstrip.png" bgcolor="#F0D1A3">
<FONT
size=-2>
<I>powered by: </I><BR> <B>[<A class=powered
href="http://www.php.net/" target=_new>
<I>PHP</I></A>]</B> + <B>[<A
class=powered href="http://www.mysql.com/"
target=_new>
mySQL</A>]</B></FONT></TD></TR>
<TR vAlign=bottom>
<TD vAlign=bottom width=132
background="images/topright.png" bgcolor="#F0D1A3">
<SPAN
class=webblermenu>
phplist</SPAN></TD></TR>
<TR>
<TD bgColor=#000000><IMG height=1 alt=""
src="images/transparent.png" width=20
border=0>
</TD>
<TD bgColor=#000000><IMG height=1 alt=""
src="images/transparent.png" width=576
border=0>
</TD>
<TD bgColor=#000000><IMG height=1 alt=""
src="images/transparent.png" width=132
border=0>
</TD></TR>
<TR vAlign=top>
<TD> </TD>
<td><div align=left>
<br />



# edit Footer of public pages
</div>
</td>
<td>
<div class="menutableright">

</div>
</td>
</tr>

<tr><td colspan="4"> </td></tr>

<tr><td colspan="4"> </td></tr>
</table>
<!--TOP TABLE ends-->

</td></tr>


<tr>
<td bgcolor="#000000" colspan=3><img height=1 alt="" src="images/transparent.png" width=1 border=0></td>
</tr>

<tr>
<td bgcolor="#000000"><img height=1 alt="" src="images/transparent.png" width=1 border=0></td>
<td bgcolor="#ff9900" class="bottom"> <a href="http://tincan.co.uk" target="_tincan" class="urhere">tincan limited</a> | <a class="urhere" href="http://www.phplist.com" target="_blank">phplist</a> - version <?php echo VERSION?></td>
<td bgcolor="#000000"><img height=1 alt="" src="images/transparent.png" width=1 border=0></td>
</tr>

<tr>
<td bgcolor="#000000" colspan=3><img height=1 alt="" src="images/transparent.png" width=1 border=0></td>
</tr>

<tr>
<td colspan=3><img height=3 alt="" src="images/transparent.png" width=1 border=0></td>
</tr>

<tr>
<td colspan=3>
 
</td>
</tr>
</tbody>
</table>

</div>
</body></html>



Charset for HTML messages
With this setting you can specify the charset for HTML messages. If you are using special (accented) characters in you messages, it is recommended you use UTF-8 (since phplist ver. 2.10.3)

# edit Charset for HTML messages
iso-8859-1


Charset for Text messages
With this setting you can specify the charset for text messages. If you are using special (accented) characters in you messages, it is recommended you use UTF-8 (since phplist ver. 2.10.3)

# edit Charset for Text messages
iso-8859-1



CSS for HTML messages without a template
If you send HTML messages without using a template, the following CSS style declaration will be inserted in the message. Please change these to match you preferences.

# edit CSS for HTML messages without a template
<style type="text/css">
body { font-size : 11px; font-family: Verdana, Arial, Helvetica, sans-serif; }
a { font-size: 11px; color: #ff6600; font-style: normal; font-family: verdana, sans-serif; text-decoration: none; }
a:visited { color: #666666; }
a:hover {  text-decoration: underline; }
p { font-weight: normal; font-size: 11px; color: #666666; font-style: normal; font-family: verdana, sans-serif; text-decoration: none; }
h1 {font-weight: bold; font-size: 14px; color: #666666; font-style: normal; font-family: verdana, sans-serif; text-decoration: none;}
h2 {font-weight: bold; font-size: 13px; color: #666666; font-style: normal; font-family: verdana, sans-serif; text-decoration: none;}
h3 {font-weight: bold; font-size: 12px; color: #666666; font-style: normal; font-family: verdana, sans-serif; text-decoration: none; margin:0px; padding:0px;}
h4 {font-weight: bold; font-size: 11px; color: #666666; font-style: normal; font-family: verdana, sans-serif; text-decoration: none; margin:0px; padding:0px;}
hr {width : 100%; height : 1px; color: #ff9900; size:1px;}
.forwardform {margin: 0 0 0 0; padding: 0 0 0 0;}
.forwardinput {margin: 0 0 0 0; padding: 0 0 0 0;}
.forwardsubmit {margin: 0 0 0 0; padding: 0 0 0 0;}
div.emailfooter { font-size : 11px; font-family: Verdana, Arial, Helvetica, sans-serif; }
div.emailfooter a { font-size: 11px; color: #ff6600; font-style: normal; font-family: verdana, sans-serif; text-decoration: none; }
</style>



Domains that only accept text emails
Some domains only accept text based messages. You can specify these domains in this text box by entering one domain per line.

# edit Domains that only accept text emails, one per line
mail.com
email.com



RSS configuration



Minimum amount of items to send in an RSS feed

# edit Minimum amount of items to send in an RSS feed


Template for text item in RSS feeds

# edit Template for text item in RSS feeds

[title]
[description]
URL: [link]


Template for HTML item in RSS feeds

# edit Template for HTML item in RSS feeds
<br/>
<a href="[link]"><b>[title]</b></a><br/>
<p>[description]</p>
<hr/>


Maximum items to send in an RSS feed

# edit Maximum amount of items to send in an RSS feed
30


Template for separator between feeds in RSS feeds (text)

# edit Template for separator between feeds in RSS feeds (text)
**** [listname] ******


Template for separator between feeds in RSS feeds (HTML)

#edit Template for separator between feeds in RSS feeds (HTML)
<br/>
<h3>[listname]</h3>



FCKeditor



Size of the FCKeditor window area
You can change the size of the FCKeditor work area to match your preferences by changing the following values (pixels).

# edit Width in px of FCKeditor Area
600

# edit Height in px of FCKeditor Area
400







CategoryDocumentation
Page was generated in 0.9957 seconds