Revision [2117]
Last edited on 2009-11-16 09:11:00 by AlStillero [Reverted SPAM by CharlotteMulquin]Deletions:
Revision [2116]
Edited on 2009-11-16 07:05:09 by CharlotteMulquinAdditions:
- [[http://www.superiorpapers.com/ Research Papers]]
Additions:
~~-This generally indicates that something is wrong with session handling in your PHP configuration. Check your php.ini file and make sure you have this set: ##session.use_cookies = 1##, and/or ask your ISP to make sure sessions are enabled in your PHP configuration and are stored correctly.
Deletions:
Revision [2111]
Edited on 2009-11-12 16:01:06 by AlStillero [Reverted SPAM - please ban CharlotteMulquin]Additions:
~~-phplist will try to interpret html tags. If you write a mathematical thesis to you list users it might catch a '<' and a '>' in the same line and remove the part in between. To avoid this, use < and >
Deletions:
- [[http://www.superiorpapers.com/ Research Papers]]
Revision [2110]
Edited on 2009-11-12 07:07:29 by CharlotteMulquinAdditions:
- [[http://www.superiorpapers.com/ Research Papers]]
Additions:
~~-This can occur when ASP tags are enable in php.ini. If you do not use ASP tags, you could set asp_tags = off in php.ini. For more information, see this [[http://mantis.phplist.com/view.php?id=11755 issue report]] and this [[http://forums.phplist.com/viewtopic.php?p=37414#37414 forum thread]].
~~-phplist will try to interpret html tags. If you write a mathematical thesis to you list users it might catch a '<' and a '>' in the same line and remove the part in between. To avoid this, use < and >
~~- will not be handled correctly. Use this instead: %%(html)nicename%%
~~-phplist will try to interpret html tags. If you write a mathematical thesis to you list users it might catch a '<' and a '>' in the same line and remove the part in between. To avoid this, use < and >
~~-
Deletions:
~~-phplist will try to interpret html tags. If you write a mathematical thesis to you list users it might catch a '<' and a '>' in the same line and remove the part in between. To avoid this, use < and >
~~-<mailto:name@domain.net> will not be handled correctly. Use this instead: %%(html)nicename%%
Revision [2101]
Edited on 2009-11-11 05:39:34 by CharlotteMulquinAdditions:
~~-This can occur when ASP tags are enable in php.ini. If you do not use ASP tags, you could set asp_tags = off in php.ini. For more information, see this [[http://mantis.phplist.com/view.php?id=11755 issue report]], this [[http://www.superiorpapers.com/ research papers]] and this [[http://forums.phplist.com/viewtopic.php?p=37414#37414 forum thread]].
Deletions:
Revision [2100]
Edited on 2009-11-11 05:38:55 by CharlotteMulquinAdditions:
~~-This can occur when ASP tags are enable in php.ini. If you do not use ASP tags, you could set asp_tags = off in php.ini. For more information, see this [[http://mantis.phplist.com/view.php?id=11755 issue report]], this [[http://www.superiorpapers.com/ research papers]] this [[http://forums.phplist.com/viewtopic.php?p=37414#37414 forum thread]].
Deletions:
Additions:
[[PhplistDocumentation phpList Documentation]]
=== Problems installing phpList ===
~-**How do I install phpList?**
~~-Have you read the [[http://docs.phplist.com/PhplistInstallation/ phpList Installation Procedure]]?
~~-Please take a look at [[http://docs.phplist.com/PhplistTroubleshooting/ phpList Troubleshooting]] to see if your problem has already been discussed.
~~-You can also browse the [[http://www.phplist.com/forums/ phpList Discussion Forum]] to see if your problems have already been discussed (and solved) there.
~~-And don't forget to read [[http://www.phplist.com/faqs phpList FAQs]] where most common problems are explained.
~-**Where can I find the 'config.php' file?**
~~-Typically it's found in '/lists/config/config.php'. You need have access to the files on your server (via FTP or SSH for example) to modify the config.php file. You cannot access it with your web browser.
~~-'Safe mode' is a feature in PHP versions prior to PHP 6. phpList works best with Safe mode disabled. It will also work in safe mode, with the exception of some features, that rely on functions in PHP that are not available in safe mode. phpList features that are not available in safe mode are automatic bounce processing, setting the timeout of a page. Mailqueue batch size will also be limited. You can turn of all php warnings in phpList by setting the following configuration in config.php:
~~-That error indicates something is wrong with your database connection details. A database connection requires four things, and they are very sensitive to errors (just one little typo and it won't work):
~~-If any of these four are incorrect, you will get this error message. It's a good idea to double-check your settings, and confirm with your ISP (web host) or system administrator what the database connection details should be. Also, the database user must have full permissions on the database specified in the 'database name' setting.
~-**Why does my website redirect to phpList.com after I install phpList?**
~~-The file '/public_html/index.html' in the phpList distribution, says 'You will probably want to replace this document with your own website' and then redirects to phpList.com. In place of this file, you probably want to put your website's index.html file. In typical installations, you only need to upload the contents of the directory '/public_html/lists/' to your web server.
~-**Can I run phpList on Microsoft IIS web webserver?**
~~-While phpList was primarily designed to work with Apache under unix-like systems (typically [[http://en.wikipedia.org/wiki/LAMP_%28solution_stack%29 LAMP]] systems), users have managed to get it running with IIS. See [[PhplistIIS]] and the forums for details on how to do this.
~~-If you use the sendmail engine provided by your ISP directly (no SMTP settings) you might have limitations on the amount of emails you can send. Due to security reasons ISPs might be reluctant to remove these limitations. So, if this happens to you the best route to take is to change the sendmail method to SMTP. This can be done by changing the phpList configuration in your config.php file.
~~-To process the mail queue and keep sending emails, phpList needs to be able to keep running. There are several ways that phpList will use to keep the queue running even if you close the browser while processing the queue. However, depending on your ISP's configuration there is a possibility that none of them will work. If this happens to you, the solution is to [[ProcessQueueInfo process the mail queue]] by using a cron job. To setup a cron job please read: [[CronJobExamples how to set a Cron Job]]
~~-If you get a '500 Server Error' when installing, your server probably runs PHP as a cgi, not as an apache module (also known as phpsuexec). You need to edit the file '/lists/.htaccess' delete or comment out (with a #) the line about 'php_flag magic_quotes_gpc'. e.g.
~~-Magic quotes is a PHP setting. If the server runs PHP as a cgi, you can turn magic quotes on by creating the file '/lists/php.ini' with this directive:
~-**When I run the initialize process it shows me an error about index length: "database error 1071 - index length too long". Why is that?**
~~-If your ISP provider offers you an old version of ""MySQL"" (4.1.X or older), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that ""MySQL"" imposes.
=== Problems after installing phpList ===
~~-Alternatively, you could convert short tags to long tags by using the ''short2long.sh'' script included in the scripts directory of the phpList archive.
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note**: If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phpList releases up to 2.10.5.
~~-In phpList versions 2.9.x and up, the "send test message" button will send you two messages, one in HTML and one in text format. This is so you can check how the messages look in both formats. Eventually, when you send your message, your subscribers will only receive one of the two formats, depending on their preferences.
~~-In the spage (subscribe pages) area of phpList, you can create and edit subscribe pages. There you can edit the html of the header and footer, where you can insert html from your website's template. If you do not have any subscribe pages, you can edit the header and footer html from the phpList configuration area.
~~-In the config.php file there is an option under the 'Feedback to developers' section that allows you to remove the phpList logo in the html emails and public web pages (including subscribe pages). You'll end up with just a text link giving credit to phpList and Tincan instead of the images.
~~-phpList's admin module currently only offers an option to [[ExportUsersInfo export the user lists]]. An option to make a backup of the entire phpList database is scheduled for a future release. In the mean time it is highly recommended to regularly make a [[BackupDatabase full backup of your phpList database]] using a tool like phpMyAdmin for instance.
~~- Security announcements can be found on the [[http://www.phplist.com/news phpList News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe phpList Newsletter]], so we can keep you up to date on any new security announcement, upcoming phpList releases, and changes in the documentation.
~~- Other language files than english.inc may need to be updated. The availability of translations does not always keep pace with new releases of phpList, and new text strings added in english.inc may still have to be added and translated in other languague files. You can fix this by adding the missing text strings in your language file. Also search the [[http://forums.phplist.com/viewforum.php?f=19 Translators & Internationalization]] forum. Updated translations may already be available there. Note: If you are thinking about translating, please see the [[PhplistTranslation phpList translation]] page.
~~-In versions before 2.10.3 phpList had some trouble converting multi-lingual messages from HTML to text. In most cases, this caused HTML characters like ''""& eacute;""'' to appear in the text versions of the messages. In version 2.10.3 this has been addressed, but it will be important to set your encoding of HTML and text messages to be UTF-8 instead of the default ISO-8859-1 . To do so, go to "configure" on the menu and scroll down to "Charset for HTML messages" and "Charset for text messages" and set both values to be "UTF-8".
=== Problems installing phpList ===
~-**How do I install phpList?**
~~-Have you read the [[http://docs.phplist.com/PhplistInstallation/ phpList Installation Procedure]]?
~~-Please take a look at [[http://docs.phplist.com/PhplistTroubleshooting/ phpList Troubleshooting]] to see if your problem has already been discussed.
~~-You can also browse the [[http://www.phplist.com/forums/ phpList Discussion Forum]] to see if your problems have already been discussed (and solved) there.
~~-And don't forget to read [[http://www.phplist.com/faqs phpList FAQs]] where most common problems are explained.
~-**Where can I find the 'config.php' file?**
~~-Typically it's found in '/lists/config/config.php'. You need have access to the files on your server (via FTP or SSH for example) to modify the config.php file. You cannot access it with your web browser.
~~-'Safe mode' is a feature in PHP versions prior to PHP 6. phpList works best with Safe mode disabled. It will also work in safe mode, with the exception of some features, that rely on functions in PHP that are not available in safe mode. phpList features that are not available in safe mode are automatic bounce processing, setting the timeout of a page. Mailqueue batch size will also be limited. You can turn of all php warnings in phpList by setting the following configuration in config.php:
~~-That error indicates something is wrong with your database connection details. A database connection requires four things, and they are very sensitive to errors (just one little typo and it won't work):
~~-If any of these four are incorrect, you will get this error message. It's a good idea to double-check your settings, and confirm with your ISP (web host) or system administrator what the database connection details should be. Also, the database user must have full permissions on the database specified in the 'database name' setting.
~-**Why does my website redirect to phpList.com after I install phpList?**
~~-The file '/public_html/index.html' in the phpList distribution, says 'You will probably want to replace this document with your own website' and then redirects to phpList.com. In place of this file, you probably want to put your website's index.html file. In typical installations, you only need to upload the contents of the directory '/public_html/lists/' to your web server.
~-**Can I run phpList on Microsoft IIS web webserver?**
~~-While phpList was primarily designed to work with Apache under unix-like systems (typically [[http://en.wikipedia.org/wiki/LAMP_%28solution_stack%29 LAMP]] systems), users have managed to get it running with IIS. See [[PhplistIIS]] and the forums for details on how to do this.
~~-If you use the sendmail engine provided by your ISP directly (no SMTP settings) you might have limitations on the amount of emails you can send. Due to security reasons ISPs might be reluctant to remove these limitations. So, if this happens to you the best route to take is to change the sendmail method to SMTP. This can be done by changing the phpList configuration in your config.php file.
~~-To process the mail queue and keep sending emails, phpList needs to be able to keep running. There are several ways that phpList will use to keep the queue running even if you close the browser while processing the queue. However, depending on your ISP's configuration there is a possibility that none of them will work. If this happens to you, the solution is to [[ProcessQueueInfo process the mail queue]] by using a cron job. To setup a cron job please read: [[CronJobExamples how to set a Cron Job]]
~~-If you get a '500 Server Error' when installing, your server probably runs PHP as a cgi, not as an apache module (also known as phpsuexec). You need to edit the file '/lists/.htaccess' delete or comment out (with a #) the line about 'php_flag magic_quotes_gpc'. e.g.
~~-Magic quotes is a PHP setting. If the server runs PHP as a cgi, you can turn magic quotes on by creating the file '/lists/php.ini' with this directive:
~-**When I run the initialize process it shows me an error about index length: "database error 1071 - index length too long". Why is that?**
~~-If your ISP provider offers you an old version of ""MySQL"" (4.1.X or older), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that ""MySQL"" imposes.
=== Problems after installing phpList ===
~~-Alternatively, you could convert short tags to long tags by using the ''short2long.sh'' script included in the scripts directory of the phpList archive.
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note**: If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phpList releases up to 2.10.5.
~~-In phpList versions 2.9.x and up, the "send test message" button will send you two messages, one in HTML and one in text format. This is so you can check how the messages look in both formats. Eventually, when you send your message, your subscribers will only receive one of the two formats, depending on their preferences.
~~-In the spage (subscribe pages) area of phpList, you can create and edit subscribe pages. There you can edit the html of the header and footer, where you can insert html from your website's template. If you do not have any subscribe pages, you can edit the header and footer html from the phpList configuration area.
~~-In the config.php file there is an option under the 'Feedback to developers' section that allows you to remove the phpList logo in the html emails and public web pages (including subscribe pages). You'll end up with just a text link giving credit to phpList and Tincan instead of the images.
~~-phpList's admin module currently only offers an option to [[ExportUsersInfo export the user lists]]. An option to make a backup of the entire phpList database is scheduled for a future release. In the mean time it is highly recommended to regularly make a [[BackupDatabase full backup of your phpList database]] using a tool like phpMyAdmin for instance.
~~- Security announcements can be found on the [[http://www.phplist.com/news phpList News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe phpList Newsletter]], so we can keep you up to date on any new security announcement, upcoming phpList releases, and changes in the documentation.
~~- Other language files than english.inc may need to be updated. The availability of translations does not always keep pace with new releases of phpList, and new text strings added in english.inc may still have to be added and translated in other languague files. You can fix this by adding the missing text strings in your language file. Also search the [[http://forums.phplist.com/viewforum.php?f=19 Translators & Internationalization]] forum. Updated translations may already be available there. Note: If you are thinking about translating, please see the [[PhplistTranslation phpList translation]] page.
~~-In versions before 2.10.3 phpList had some trouble converting multi-lingual messages from HTML to text. In most cases, this caused HTML characters like ''""& eacute;""'' to appear in the text versions of the messages. In version 2.10.3 this has been addressed, but it will be important to set your encoding of HTML and text messages to be UTF-8 instead of the default ISO-8859-1 . To do so, go to "configure" on the menu and scroll down to "Charset for HTML messages" and "Charset for text messages" and set both values to be "UTF-8".
Deletions:
=== Problems installing Phplist ===
~-**How do I install phplist?**
~~-Have you read the [[http://docs.phplist.com/PhplistInstallation/ Phplist Installation Procedure]]?
~~-Please take a look at [[http://docs.phplist.com/PhplistTroubleshooting/ Phplist Troubleshooting]] to see if your problem has already been discussed.
~~-You can also browse the [[http://www.phplist.com/forums/ Phplist Discussion Forum]] to see if your problems have already been discussed (and solved) there.
~~-And don't forget to read [[http://www.phplist.com/faqs Phplist FAQs]] where most commom problems are explained.
~-**Where is file 'config.php'?**
~~-Typically it's found at '/public_html/lists/config/config.php'. You need access to the files on your server (via FTP or SSH for example) to modify the config.php file. You cannot access it with your web browser.
~~-'Safe mode' is a feature in PHP versions prior to PHP 6. phplist works safe mode, with the exception of some features, that rely on features in PHP that are not available in safe mode. phplist features that are not available in safe mode are bounces, setting the timeout of a page. You can turn of all php warnings in phplist by setting the following configuration in config.php:
~~-That error indicates there is something wrong with your database connection details. A database connection requires four things, and they are very sensitive to errors (just one little typo and it won't work):
~~-If any of these four are incorrect, you will get this error message. It's a good idea to double check your settings, and confirm with your ISP (web host) or system administrator what the database connection details are. Also, the database user must have full permissions on the database in 'database name'.
~-**Why does my website redirect to phplist.com after I install phplist?**
~~-The file '/public_html/index.html' in the phplist distribution, says 'You will probably want to replace this document with your own website' and then redirects to phplist.com. In place of this file, you probably want to put your websites index file. In typical installations, you only need to upload the contents of the directory '/public_html/lists/' to your web server.
~-**Can I run phplist on Microsoft IIS web webserver?**
~~-See [[PhplistIIS]] for details on how to do this.
~~-If you use the sendmail engine provided by your ISP directly (no SMTP settings) you might have limitations on the amount of emails you can send. Due to security reasons ISPs are reluctant to remove this limitation. So, if this happens to you the best route to take is to change the sendmail method to SMTP. This can be done by changing the phpList configuration.
~~-To process the queue and keep sending emails phpList needs to be able to keep running. There are several ways that phpList will use to keep the queue running even if you close the browser while processing the queue, but depending on your ISP configuration there is a possibility that none of them will work. If this happens to you the solution is to run the queues using a cron job. To set a cron job please read: [[CronJobExamples how to set a Cron Job]]
~~-If you get a '500 Server Error' when installing, your server probably runs php as a cgi, not as an apache module (also known as phpsuexec). You need to edit the file '/lists/.htaccess' delete or comment out (with a #) the line about 'php_flag magic_quotes_gpc'. e.g.
~~-Magic quotes is a PHP setting. If the server runs php as a cgi, you can turn magic quotes on by creating the file '/lists/php.ini' with this directive:
~-**When I run the initialize process it shows me an error about index length: "database error 1071 - index length too long". What is that for?**
~~-If your ISP provider offer you an old version of ""MySQL"" (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that ""MySQL"" imposes.
=== Problems after installing Phplist ===
~~-Alternatively, you could convert short tags to long tags by using the ''short2long.sh'' script included in the scripts directory of the phplist archive.
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note**: If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phplist releases up to 2.10.5.
~~-In phpList versions 2.9.x and up, the "send test message" button will send you two messages, one in HTML and one in text format. This is so you can check that the messages come out ok in both formats. Eventually when you send your message, your subscribers will only receive one of the two, depending on their preferences.
~~-In the spage (subscribe pages) area of phplist, you can create and edit subscribe pages. There you can edit the html of the header and footer, where you can insert html from your website's template. If you do not have any subscribe pages, you can edit the header and footer html from the phplist configuration area.
~~-In the config.php file there is an option under the 'Feedback to developers' section that allows you to remove the phplist images in the html emails and public web pages (including subscribe pages). You'll end up with just a text link credit to phplist and tincan instead of the images.
~~-phpList's admin module currently only offers an option to [[ExportUsersInfo export the user lists]]. An option to make a backup of the entire phplist database is scheduled for a future release. In the mean time it is highly recommended to regularly make a [[BackupDatabase full backup of your phplist database]] using a tool like phpMyAdmin for instance.
~~- Security announcements can be found on the [[http://www.phplist.com/news phpList News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe phpList Newsletter]], so we can keep you up to date on any new security announcement, upcoming phpList releases, and changes in the document""insert-raw-html-here""ation.
~~- Other language files than english.inc may need to be updated. The availability of translations does not always keep pace with new releases of phplist, and new text strings added in english.inc may still have to be added and translated in other languague files. You can fix this by adding the missing text strings in your language file. Also search the [[http://forums.phplist.com/viewforum.php?f=19 Translators & Internationalization]] forum. Updated translations may already be available there. Note: If you are thinking about translating, please see the [[PhplistTranslation phpList translation]] page.
~~-In versions before 2.10.3 phplist had some trouble converting multi-lingual messages from HTML to text. In most cases, this caused HTML characters like ''""& eacute;""'' to appear in the text versions of the messages. In version 2.10.3 this has been addressed, but it will be important to set your encoding of HTML and text messages to be UTF-8 instead of the default ISO-8859-1 . To do so, go to "configure" on the menu and scroll down to "Charset for HTML messages" and "Charset for text messages" and set both values to be "UTF-8".
Revision [2026]
Edited on 2009-10-07 13:20:07 by AlStillero [Added link to mantis report + minor changes]Additions:
~-**What server setup is required for running phpList?**
~~-If your ISP provider offer you an old version of ""MySQL"" (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that ""MySQL"" imposes.
~-**Why does phpList ask me to login for every admin page I try to load?**
~~-The temporary directory has filled up with temporary files, and phpList is unable to write to it. You can fix this by cleaning up your temp dir.
~~-Alternatively, you can store sessions in the database instead of the default place by assigning a table name to this value. Enable this setting in config.php: ##""$SessionTableName"" = "phplistsessions";## by uncommenting this line. The table will be created and will not use any prefixes. This only works when using ""mySQL"" and only for administrator sessions.
~-**I just installed phpList, but sending my first messages fails. Why can't I send any message?**
~~-Please check if phpList is still running in Test mode. In config.php check your value for this constant (0 is off, 1 is on): define ("TEST",0); . See also [[http://docs.phplist.com/PhpListPreflight/ Preflight Checklist]].
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note**: If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phplist releases up to 2.10.5.
~~-In phpList versions 2.9.x and up, the "send test message" button will send you two messages, one in HTML and one in text format. This is so you can check that the messages come out ok in both formats. Eventually when you send your message, your subscribers will only receive one of the two, depending on their preferences.
~~- Security announcements can be found on the [[http://www.phplist.com/news phpList News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe phpList Newsletter]], so we can keep you up to date on any new security announcement, upcoming phpList releases, and changes in the document""insert-raw-html-here""ation.
~~- Other language files than english.inc may need to be updated. The availability of translations does not always keep pace with new releases of phplist, and new text strings added in english.inc may still have to be added and translated in other languague files. You can fix this by adding the missing text strings in your language file. Also search the [[http://forums.phplist.com/viewforum.php?f=19 Translators & Internationalization]] forum. Updated translations may already be available there. Note: If you are thinking about translating, please see the [[PhplistTranslation phpList translation]] page.
- [[PhpListConfiguration Configuring phpList]]
~~-If your ISP provider offer you an old version of ""MySQL"" (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that ""MySQL"" imposes.
~-**Why does phpList ask me to login for every admin page I try to load?**
~~-The temporary directory has filled up with temporary files, and phpList is unable to write to it. You can fix this by cleaning up your temp dir.
~~-Alternatively, you can store sessions in the database instead of the default place by assigning a table name to this value. Enable this setting in config.php: ##""$SessionTableName"" = "phplistsessions";## by uncommenting this line. The table will be created and will not use any prefixes. This only works when using ""mySQL"" and only for administrator sessions.
~-**I just installed phpList, but sending my first messages fails. Why can't I send any message?**
~~-Please check if phpList is still running in Test mode. In config.php check your value for this constant (0 is off, 1 is on): define ("TEST",0); . See also [[http://docs.phplist.com/PhpListPreflight/ Preflight Checklist]].
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note**: If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phplist releases up to 2.10.5.
~~-In phpList versions 2.9.x and up, the "send test message" button will send you two messages, one in HTML and one in text format. This is so you can check that the messages come out ok in both formats. Eventually when you send your message, your subscribers will only receive one of the two, depending on their preferences.
~~- Security announcements can be found on the [[http://www.phplist.com/news phpList News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe phpList Newsletter]], so we can keep you up to date on any new security announcement, upcoming phpList releases, and changes in the document""insert-raw-html-here""ation.
~~- Other language files than english.inc may need to be updated. The availability of translations does not always keep pace with new releases of phplist, and new text strings added in english.inc may still have to be added and translated in other languague files. You can fix this by adding the missing text strings in your language file. Also search the [[http://forums.phplist.com/viewforum.php?f=19 Translators & Internationalization]] forum. Updated translations may already be available there. Note: If you are thinking about translating, please see the [[PhplistTranslation phpList translation]] page.
- [[PhpListConfiguration Configuring phpList]]
Deletions:
~~-If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that MySQL imposes.
~-**Why does PHPlist ask me to login for every admin page I try to load?**
~~-The temporary directory has filled up with temporary files, and PHPlist is unable to write to it. You can fix this by cleaning up your temp dir.
~~-Alternatively, you can store sessions in the database instead of the default place by assigning a table name to this value. Enable this setting in config.php: $SessionTableName = "phplistsessions"; by uncommenting this line. The table will be created and will not use any prefixes. This only works when using mySQL and only for administrator sessions.
~-**I just installed PHPlist, but sending my first messages fails. Why can't I send any message?**
~~-Please check if PHPlist is still running in Test mode. In config.php check your value for this constant (0 is off, 1 is on): define ("TEST",0); . See also [[http://docs.phplist.com/PhpListPreflight/ Preflight Checklist]].
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. Note: If you use SMTP, make sure you apply this bug fix which is valid for phplist releases up to 2.10.5.
~~-In PHPlist versions 2.9.x and up, the "send test message" button will send you two messages, one in HTML and one in text format. This is so you can check that the messages come out ok in both formats. Eventually when you send your message, your subscribers will only receive one of the two, depending on their preferences.
~~- Security announcements can be found on the [[http://www.phplist.com/news PHPlist News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe PHPlist Newsletter]], so we can keep you up to date on any new security announcement, upcoming PHPlist releases, and changes in the document""insert-raw-html-here""ation.
~~- Other language files than english.inc may need to be updated. The availability of translations does not always keep pace with new releases of phplist, and new text strings added in english.inc may still have to be added and translated in other languague files. You can fix this by adding the missing text strings in your language file. Also search the [[http://forums.phplist.com/viewforum.php?f=19 Translators & Internationalization]] forum. Updated translations may already be available there. Note: If you are thinking about translating, please see the [[PhplistTranslation PHPlist translation]] page.
- [[PhpListConfiguration Configuring PHPlist]]
Revision [1957]
Edited on 2009-04-24 13:46:43 by IgnacioBonelliAdditions:
~~-There are two main reasons for this to happen: Limitations of the sendmail program provided by your ISP, or that you are trying to process big queues directly from the browser.
~~-To process the queue and keep sending emails phpList needs to be able to keep running. There are several ways that phpList will use to keep the queue running even if you close the browser while processing the queue, but depending on your ISP configuration there is a possibility that none of them will work. If this happens to you the solution is to run the queues using a cron job. To set a cron job please read: [[CronJobExamples how to set a Cron Job]]
~~-To process the queue and keep sending emails phpList needs to be able to keep running. There are several ways that phpList will use to keep the queue running even if you close the browser while processing the queue, but depending on your ISP configuration there is a possibility that none of them will work. If this happens to you the solution is to run the queues using a cron job. To set a cron job please read: [[CronJobExamples how to set a Cron Job]]
Revision [1956]
Edited on 2009-04-21 15:15:48 by CarolSampaioAdditions:
=== Problems installing Phplist ===
~-**How do I install phplist?**
~~-Please refer to the installation instructions in the [[http://docs.phplist.com/PhplistInstallation/ Online Documentation Wiki]], which are also available in the '/INSTALL' file in the distribution.
~~-Please take a look at the [[http://docs.phplist.com/SystemRequirements/ System Requirements]].
~~-Have you read the [[http://docs.phplist.com/PhplistInstallation/ Phplist Installation Procedure]]?
~~-Please take a look at [[http://docs.phplist.com/PhplistTroubleshooting/ Phplist Troubleshooting]] to see if your problem has already been discussed.
~~-You can also browse the [[http://www.phplist.com/forums/ Phplist Discussion Forum]] to see if your problems have already been discussed (and solved) there.
~~-In particular the [[http://www.phplist.com/forums/viewforum.php?f=5 FAQ Forum]] is a good place to start.
~~-And don't forget to read [[http://www.phplist.com/faqs Phplist FAQs]] where most commom problems are explained.
~-**Where is file 'config.php'?**
~~-Typically it's found at '/public_html/lists/config/config.php'. You need access to the files on your server (via FTP or SSH for example) to modify the config.php file. You cannot access it with your web browser.
~-**What does 'Safe Mode On' mean?**
~~-'Safe mode' is a feature in PHP versions prior to PHP 6. phplist works safe mode, with the exception of some features, that rely on features in PHP that are not available in safe mode. phplist features that are not available in safe mode are bounces, setting the timeout of a page. You can turn of all php warnings in phplist by setting the following configuration in config.php:
~~- define ('WARN_ABOUT_PHP_SETTINGS',0);
~-**Fatal Error: Cannot connect to database, access denied. Please contact the administrator**
~~-That error indicates there is something wrong with your database connection details. A database connection requires four things, and they are very sensitive to errors (just one little typo and it won't work):
~~ *database host*; the name of the server, usually it's 'localhost')
~~ *database user*; the name of the user on the database host
~~ *database password*; the password for that user
~~ *database name*; the name of the database to use
~~-If any of these four are incorrect, you will get this error message. It's a good idea to double check your settings, and confirm with your ISP (web host) or system administrator what the database connection details are. Also, the database user must have full permissions on the database in 'database name'.
~-**Why does my website redirect to phplist.com after I install phplist?**
~~-The file '/public_html/index.html' in the phplist distribution, says 'You will probably want to replace this document with your own website' and then redirects to phplist.com. In place of this file, you probably want to put your websites index file. In typical installations, you only need to upload the contents of the directory '/public_html/lists/' to your web server.
~~-This is currently not possible without a small modification of the code described in [[http://mantis.phplist.com/view.php?id=11493 this report]]. After the modification you should be able to change the standard SMTP port by inserting this line in config.php: ''$phpmailer_smtpport = 'xxx';'' (where **xxx** is the port number).
~-**Why do I get a 500 Server Error?**
~~-If you get a '500 Server Error' when installing, your server probably runs php as a cgi, not as an apache module (also known as phpsuexec). You need to edit the file '/lists/.htaccess' delete or comment out (with a #) the line about 'php_flag magic_quotes_gpc'. e.g.
~~ # php_flag magic_quotes_gpc on
~-**What does 'magic_quotes_gpc = on' mean?**
~~-Magic quotes is a PHP setting. If the server runs php as a cgi, you can turn magic quotes on by creating the file '/lists/php.ini' with this directive:
~~ magic_quotes_gpc = 1
~~-More information about php settings in phpsuexec mode.
~~-If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that MySQL imposes.
//(More answers to common warning and error messages can be found on [[http://docs.phplist.com/PhplistTroubleshooting/ Troubleshooting]]).//
=== Problems after installing Phplist ===
~-**Why does PHPlist ask me to login for every admin page I try to load?**
~~-This generally indicates that something is wrong with session handling in your PHP configuration. Check your php.ini file, or ask your ISP to make sure sessions are stored correctly.
~~-The temporary directory on your server doesn't have read/write permissions. Please make sure that it does have read/write permissions.
~~-The temporary directory has filled up with temporary files, and PHPlist is unable to write to it. You can fix this by cleaning up your temp dir.
~~-You are connecting through multiple proxies and this means that your IP address isn't the same for every page request. (AOL is an example of an ISP that connects in this way.) You can solve this in config.php, by setting define("CHECK_SESSIONIP",0);
~~-Alternatively, you can store sessions in the database instead of the default place by assigning a table name to this value. Enable this setting in config.php: $SessionTableName = "phplistsessions"; by uncommenting this line. The table will be created and will not use any prefixes. This only works when using mySQL and only for administrator sessions.
~-**When loading the admin page I get some PHP code instead of a clean page. How do I fix this?**
~~-Please check if PHPlist is still running in Test mode. In config.php check your value for this constant (0 is off, 1 is on): define ("TEST",0); . See also [[http://docs.phplist.com/PhpListPreflight/ Preflight Checklist]].
~~-When sending a 'test message' you should also check that your email address is included in the user list. If not, you will get this error message: "Email address not found to send test message".
~~-If you are trying to send a message to a subscribers list, make sure you process the message queue. Otherwise your message will just be waiting in the queue.
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. Note: If you use SMTP, make sure you apply this bug fix which is valid for phplist releases up to 2.10.5.
~~-You can set all subscribers to receive HTML messages through the Admin backend: click on "manage users", then on "reconcile users" and finally on "mark all users to receive html". See [[ReconcileUsersInfo Reconcile users]].
~-**How do I make my own subscribe pages?**
~~-In the spage (subscribe pages) area of phplist, you can create and edit subscribe pages. There you can edit the html of the header and footer, where you can insert html from your website's template. If you do not have any subscribe pages, you can edit the header and footer html from the phplist configuration area.
~~-Please read the [[CustomSubscribeForm Create custom subscribe form]] page. Also, you should find many examples of how to do this by searching the forum.
~~-In the config.php file there is an option under the 'Feedback to developers' section that allows you to remove the phplist images in the html emails and public web pages (including subscribe pages). You'll end up with just a text link credit to phplist and tincan instead of the images.
~-**Why do I lose all characters over 255 when I enter a long text in a textarea attribute?**
~~-The data entered into the textarea is stored in the database. To prevent the database from becoming big and slow this is done using a 'varchar', which has a 255 characters limit. If you do want to use a bigger textarea attribute look for the solution in the forums. It has been done before: here is one solution and this has some more explanation. The code support it.
~~-You probably created a subscribe page before changing the settings on the configuration page. When you create a new subscribe page, it will take its initial settings from the defaults on the configuration page. Of course you can change these settings for each individual subscribe page you create. So, either create a new subscribe page, or copy/paste what you have on the configuration page to the corresponding fields in your existing subscribe page. See also [[http://docs.phplist.com/EditSubscribePageInfo Edit or create a subscribe page]].
~~-phpList's admin module currently only offers an option to [[ExportUsersInfo export the user lists]]. An option to make a backup of the entire phplist database is scheduled for a future release. In the mean time it is highly recommended to regularly make a [[BackupDatabase full backup of your phplist database]] using a tool like phpMyAdmin for instance.
~~- Security announcements can be found on the [[http://www.phplist.com/news PHPlist News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe PHPlist Newsletter]], so we can keep you up to date on any new security announcement, upcoming PHPlist releases, and changes in the document""insert-raw-html-here""ation.
~-**How do I install phplist?**
~~-Please refer to the installation instructions in the [[http://docs.phplist.com/PhplistInstallation/ Online Documentation Wiki]], which are also available in the '/INSTALL' file in the distribution.
~~-Please take a look at the [[http://docs.phplist.com/SystemRequirements/ System Requirements]].
~~-Have you read the [[http://docs.phplist.com/PhplistInstallation/ Phplist Installation Procedure]]?
~~-Please take a look at [[http://docs.phplist.com/PhplistTroubleshooting/ Phplist Troubleshooting]] to see if your problem has already been discussed.
~~-You can also browse the [[http://www.phplist.com/forums/ Phplist Discussion Forum]] to see if your problems have already been discussed (and solved) there.
~~-In particular the [[http://www.phplist.com/forums/viewforum.php?f=5 FAQ Forum]] is a good place to start.
~~-And don't forget to read [[http://www.phplist.com/faqs Phplist FAQs]] where most commom problems are explained.
~-**Where is file 'config.php'?**
~~-Typically it's found at '/public_html/lists/config/config.php'. You need access to the files on your server (via FTP or SSH for example) to modify the config.php file. You cannot access it with your web browser.
~-**What does 'Safe Mode On' mean?**
~~-'Safe mode' is a feature in PHP versions prior to PHP 6. phplist works safe mode, with the exception of some features, that rely on features in PHP that are not available in safe mode. phplist features that are not available in safe mode are bounces, setting the timeout of a page. You can turn of all php warnings in phplist by setting the following configuration in config.php:
~~- define ('WARN_ABOUT_PHP_SETTINGS',0);
~-**Fatal Error: Cannot connect to database, access denied. Please contact the administrator**
~~-That error indicates there is something wrong with your database connection details. A database connection requires four things, and they are very sensitive to errors (just one little typo and it won't work):
~~ *database host*; the name of the server, usually it's 'localhost')
~~ *database user*; the name of the user on the database host
~~ *database password*; the password for that user
~~ *database name*; the name of the database to use
~~-If any of these four are incorrect, you will get this error message. It's a good idea to double check your settings, and confirm with your ISP (web host) or system administrator what the database connection details are. Also, the database user must have full permissions on the database in 'database name'.
~-**Why does my website redirect to phplist.com after I install phplist?**
~~-The file '/public_html/index.html' in the phplist distribution, says 'You will probably want to replace this document with your own website' and then redirects to phplist.com. In place of this file, you probably want to put your websites index file. In typical installations, you only need to upload the contents of the directory '/public_html/lists/' to your web server.
~~-This is currently not possible without a small modification of the code described in [[http://mantis.phplist.com/view.php?id=11493 this report]]. After the modification you should be able to change the standard SMTP port by inserting this line in config.php: ''$phpmailer_smtpport = 'xxx';'' (where **xxx** is the port number).
~-**Why do I get a 500 Server Error?**
~~-If you get a '500 Server Error' when installing, your server probably runs php as a cgi, not as an apache module (also known as phpsuexec). You need to edit the file '/lists/.htaccess' delete or comment out (with a #) the line about 'php_flag magic_quotes_gpc'. e.g.
~~ # php_flag magic_quotes_gpc on
~-**What does 'magic_quotes_gpc = on' mean?**
~~-Magic quotes is a PHP setting. If the server runs php as a cgi, you can turn magic quotes on by creating the file '/lists/php.ini' with this directive:
~~ magic_quotes_gpc = 1
~~-More information about php settings in phpsuexec mode.
~~-If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that MySQL imposes.
//(More answers to common warning and error messages can be found on [[http://docs.phplist.com/PhplistTroubleshooting/ Troubleshooting]]).//
=== Problems after installing Phplist ===
~-**Why does PHPlist ask me to login for every admin page I try to load?**
~~-This generally indicates that something is wrong with session handling in your PHP configuration. Check your php.ini file, or ask your ISP to make sure sessions are stored correctly.
~~-The temporary directory on your server doesn't have read/write permissions. Please make sure that it does have read/write permissions.
~~-The temporary directory has filled up with temporary files, and PHPlist is unable to write to it. You can fix this by cleaning up your temp dir.
~~-You are connecting through multiple proxies and this means that your IP address isn't the same for every page request. (AOL is an example of an ISP that connects in this way.) You can solve this in config.php, by setting define("CHECK_SESSIONIP",0);
~~-Alternatively, you can store sessions in the database instead of the default place by assigning a table name to this value. Enable this setting in config.php: $SessionTableName = "phplistsessions"; by uncommenting this line. The table will be created and will not use any prefixes. This only works when using mySQL and only for administrator sessions.
~-**When loading the admin page I get some PHP code instead of a clean page. How do I fix this?**
~~-Please check if PHPlist is still running in Test mode. In config.php check your value for this constant (0 is off, 1 is on): define ("TEST",0); . See also [[http://docs.phplist.com/PhpListPreflight/ Preflight Checklist]].
~~-When sending a 'test message' you should also check that your email address is included in the user list. If not, you will get this error message: "Email address not found to send test message".
~~-If you are trying to send a message to a subscribers list, make sure you process the message queue. Otherwise your message will just be waiting in the queue.
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the PHPMAILERHOST setting in your config.php file and enter your SMTP server name, e.g. define("PHPMAILERHOST",'mail.yourdomain.com'); You will also need to enter your SMTP server's username and password by editing and uncommenting (i.e. by removing the # at the start of the line) the phpmailer_smtpuser and phpmailer_smtppassword settings in config.php. Usually the SMTP settings you would use in your email client should work here too. Note: If you use SMTP, make sure you apply this bug fix which is valid for phplist releases up to 2.10.5.
~~-You can set all subscribers to receive HTML messages through the Admin backend: click on "manage users", then on "reconcile users" and finally on "mark all users to receive html". See [[ReconcileUsersInfo Reconcile users]].
~-**How do I make my own subscribe pages?**
~~-In the spage (subscribe pages) area of phplist, you can create and edit subscribe pages. There you can edit the html of the header and footer, where you can insert html from your website's template. If you do not have any subscribe pages, you can edit the header and footer html from the phplist configuration area.
~~-Please read the [[CustomSubscribeForm Create custom subscribe form]] page. Also, you should find many examples of how to do this by searching the forum.
~~-In the config.php file there is an option under the 'Feedback to developers' section that allows you to remove the phplist images in the html emails and public web pages (including subscribe pages). You'll end up with just a text link credit to phplist and tincan instead of the images.
~-**Why do I lose all characters over 255 when I enter a long text in a textarea attribute?**
~~-The data entered into the textarea is stored in the database. To prevent the database from becoming big and slow this is done using a 'varchar', which has a 255 characters limit. If you do want to use a bigger textarea attribute look for the solution in the forums. It has been done before: here is one solution and this has some more explanation. The code support it.
~~-You probably created a subscribe page before changing the settings on the configuration page. When you create a new subscribe page, it will take its initial settings from the defaults on the configuration page. Of course you can change these settings for each individual subscribe page you create. So, either create a new subscribe page, or copy/paste what you have on the configuration page to the corresponding fields in your existing subscribe page. See also [[http://docs.phplist.com/EditSubscribePageInfo Edit or create a subscribe page]].
~~-phpList's admin module currently only offers an option to [[ExportUsersInfo export the user lists]]. An option to make a backup of the entire phplist database is scheduled for a future release. In the mean time it is highly recommended to regularly make a [[BackupDatabase full backup of your phplist database]] using a tool like phpMyAdmin for instance.
~~- Security announcements can be found on the [[http://www.phplist.com/news PHPlist News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe PHPlist Newsletter]], so we can keep you up to date on any new security announcement, upcoming PHPlist releases, and changes in the document""insert-raw-html-here""ation.
Deletions:
~~-Please take a look at the [[SystemRequirements system requirements]].
~~-Have you read the [[PhplistInstallation installation procedure]]?
~~-Please take a look at PhplistTroubleshooting to see if your problem has already been discussed.
~~-You can also browse the [[http://www.phplist.com/forums/ phplist discussion forum]] to see if your problems have already been discussed (and solved) there.
~~-In particular the [[http://www.phplist.com/forums/viewforum.php?f=5 FAQ forum]] is a good place to start.
~~-And don't forget to read [[http://www.phplist.com/faqs phplist FAQs]] where most commom problems are explained.
~-**I just installed phplist. When loading the admin page I get some PHP code instead of a clean page. How do I fix this?**
~~-""""This is currently not possible without a small modification of the code described in [[http://mantis.phplist.com/view.php?id=11493 this report]]. After the modification you should be able to change the standard SMTP port by inserting this line in config.php: ''$phpmailer_smtpport = 'xxx';'' (where **xxx** is the port number).
~~-Please check if PHPlist is still running in Test mode. In config.php check your value for this constant (0 is off, 1 is on): ''define ("TEST",0);'' . See also [[PhpListPreflight Preflight Checklist]].
~~-When sending a 'test message' you should also check that your email address is included in the user list. If not, you will get this error message: "//Email address not found to send test message//".
~~-If you are trying to send a message to a subscribers list, make sure you [[ProcessQueueInfo process the message queue]]. Otherwise your message will just be waiting in the queue.
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the ''PHPMAILERHOST'' setting in your [[PhpListConfiguration config.php]] file and enter your SMTP server name, e.g. ''define("PHPMAILERHOST",'mail.yourdomain.com');'' You will also need to enter your SMTP server's username and password by editing and //uncommenting// (i.e. by removing the **#** at the start of the line) the ''phpmailer_smtpuser'' and ''phpmailer_smtppassword'' settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note:** If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phplist releases up to 2.10.5.
~-**Why does PHPlist ask me to login for every admin page I try to load?**
~~- This generally indicates that something is wrong with session handling in your PHP configuration. Check your php.ini file, or ask your ISP to make sure sessions are stored correctly.
~~- The temporary directory on your server doesn't have read/write permissions. Please make sure that it does have read/write permissions.
~~- The temporary directory has filled up with temporary files, and PHPlist is unable to write to it. You can fix this by cleaning up your temp dir.
~~- You are connecting through multiple proxies and this means that your IP address isn't the same for every page request. (AOL is an example of an ISP that connects in this way.) You can solve this in config.php, by setting ''//define("CHECK_SESSIONIP",0);//''
~~- Alternatively, you can store sessions in the database instead of the default place by assigning a table name to this value. Enable this setting in config.php: ''""$SessionTableName = "phplistsessions";""'' by uncommenting this line. The table will be created and will not use any prefixes. This only works when using mySQL and only for administrator sessions.
~~- You probably created a subscribe page before changing the settings on the configuration page. When you create a new subscribe page, it will take its initial settings from the defaults on the configuration page. Of course you can change these settings for each individual subscribe page you create. So, either create a new subscribe page, or copy/paste what you have on the configuration page to the corresponding fields in your existing subscribe page. See also [[http://docs.phplist.com/EditSubscribePageInfo Edit or create a subscribe page]].
~~- Please read the [[CustomSubscribeForm Create custom subscribe form]] page. Also, you should find many examples of how to do this by searching the forum.
~~- In the config.php file there is an option under the 'Feedback to developers' section that allows you to remove the phplist images in the html emails and public web pages (including subscribe pages). You'll end up with just a text link credit to phplist and tincan instead of the images.
~~- You can set all subscribers to receive HTML messages through the Admin backend: click on "manage users", then on "reconcile users" and finally on "mark all users to receive html". See [[ReconcileUsersInfo Reconcile users]].
~~- phpList's admin module currently only offers an option to [[ExportUsersInfo export the user lists]]. An option to make a backup of the entire phplist database is scheduled for a future release. In the mean time it is highly recommended to regularly make a [[BackupDatabase full backup of your phplist database]] using a tool like phpMyAdmin for instance.
~~- Security announcements can be found on the [[http://www.phplist.com/news PHPlist News]] page. We recommend you subscribe to the [[http://www.phplist.com/subscribe PHPlist Newsletter]], so we can keep you up to date on any new security announcement, upcoming PHPlist releases, and changes in the documentation.
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that MySQL imposes.
Revision [1885]
Edited on 2009-04-01 20:35:53 by IgnacioBonelliAdditions:
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total length of it needs to be less that the 1000 bytes limit that MySQL imposes.
Deletions:
Revision [1884]
Edited on 2009-04-01 20:35:36 by IgnacioBonelliAdditions:
~-**When I run the initialize process it shows me an error about index length: "database error 1071 - index length too long". What is that for?**
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total lenght of it needs to be less that the 1000 bytes limit that MySQL imposes.
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). This error message appears below a table name, that table is the one that has the index with errors. So, you will need to reduce the size of the field, or set of fields. The total lenght of it needs to be less that the 1000 bytes limit that MySQL imposes.
Deletions:
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). Maybe the index you are trying to create is using a field soo long, or is using a set of fields, and adding this lengths probably you have a length of 1000 bytes (or bigger than this).
Revision [1883]
Edited on 2009-04-01 19:49:00 by OmarPirrelloAdditions:
~~-If you use the sendmail engine provided by your ISP directly (no SMTP settings) you might have limitations on the amount of emails you can send. Due to security reasons ISPs are reluctant to remove this limitation. So, if this happens to you the best route to take is to change the sendmail method to SMTP. This can be done by changing the phpList configuration.
~-**When I run the initialize process, The process show me an error about index length, in the creation of a table (index length soo big), what is that for?**
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). Maybe the index you are trying to create is using a field soo long, or is using a set of fields, and adding this lengths probably you have a length of 1000 bytes (or bigger than this).
~-**When I run the initialize process, The process show me an error about index length, in the creation of a table (index length soo big), what is that for?**
~~- If your ISP provider offer you an old version of MySQL (4.1.X or less), is possible this error arise because in old versions, indexes length has a byte limitation (1000 bytes). Maybe the index you are trying to create is using a field soo long, or is using a set of fields, and adding this lengths probably you have a length of 1000 bytes (or bigger than this).
Deletions:
Revision [1880]
Edited on 2009-03-31 16:50:16 by IgnacioBonelliAdditions:
~-**My phpList installation has limitations on the amount of emails it can send**
~~-If you use the sendmail engine provided by your ISP directly (no SMTP settings) you might have limitations on the amount of emails you can send. Due to security reasons ISPs are reluctant to remove this limitation. So, if this happens to you the best route to take is to change the sendmail method to SMTP. This can be done by chaging the phpList configuration.
~~-If you use the sendmail engine provided by your ISP directly (no SMTP settings) you might have limitations on the amount of emails you can send. Due to security reasons ISPs are reluctant to remove this limitation. So, if this happens to you the best route to take is to change the sendmail method to SMTP. This can be done by chaging the phpList configuration.
Revision [1670]
Edited on 2008-10-20 14:45:06 by JulianSAdditions:
~~-It is recommended not to include links to Javascript files when sending an HTML email, since the receiving servers may quarantine or block it, due to consider it a a possible virus or unauthorised code.
Revision [1585]
Edited on 2008-05-26 19:06:36 by AlStillero [added FAQ on FCKeditor - blank page issue]Additions:
~-**When I try to edit a message, or a message template, the part where the editing window should be is blank. How can I fix this?**
~~-This can occur when ASP tags are enable in php.ini. If you do not use ASP tags, you could set asp_tags = off in php.ini. For more information, see this [[http://mantis.phplist.com/view.php?id=11755 issue report]] and this [[http://forums.phplist.com/viewtopic.php?p=37414#37414 forum thread]].
~~-Alternatively, if you do not need an online editor, you can [[UsingFCKEditor disable FCKeditor]] in your config.php file. The message [[SendMessageInfo content tab]] would then display a simple source window where you can paste your text and HTML source code.
~~-This can occur when ASP tags are enable in php.ini. If you do not use ASP tags, you could set asp_tags = off in php.ini. For more information, see this [[http://mantis.phplist.com/view.php?id=11755 issue report]] and this [[http://forums.phplist.com/viewtopic.php?p=37414#37414 forum thread]].
~~-Alternatively, if you do not need an online editor, you can [[UsingFCKEditor disable FCKeditor]] in your config.php file. The message [[SendMessageInfo content tab]] would then display a simple source window where you can paste your text and HTML source code.
Additions:
~~-If the above does not apply, it is likely something is wrong with your mail server settings. If you are using the PHP mail() function (which is the default setting in config.php), your host may have limited it's use. In that case you should contact your host to fix this. Alternatively, you could switch to using your SMTP server instead. To do so, edit the ''PHPMAILERHOST'' setting in your [[PhpListConfiguration config.php]] file and enter your SMTP server name, e.g. ''define("PHPMAILERHOST",'mail.yourdomain.com');'' You will also need to enter your SMTP server's username and password by editing and //uncommenting// (i.e. by removing the **#** at the start of the line) the ''phpmailer_smtpuser'' and ''phpmailer_smtppassword'' settings in config.php. Usually the SMTP settings you would use in your email client should work here too. **Note:** If you use SMTP, make sure you apply [[http://mantis.phplist.com/view.php?id=8590 this bug fix]] which is valid for phplist releases up to 2.10.5.
