Wydrukuj tę dokumentację Pokaż jako slajdy

Konfiguracja oraz uruchomienie phpList

phplist to oprogramowanie pozwalające na tworzenie kampanii mailowych dla zdefiniowanych grup użytkowników (adresów email). Owe kampanie mailowe można wysyłać zgodnie z zadanym harmonogramem, tak aby serwery pocztowe rozsyłały maile w godzinach najmniejszego obciążenia.

Instalacja

Z wykorzystaniem własnego repozytroium pakietów należy zainstalować:

pkg install -Uy mail/phplist print/fpdf

Biblioteka print/fpdf jest wykorzystywana przez phplist (poprzez plik konfiguracyjny).

Konfiguracja

Konfiguracja jest rozrzucona w dwa miejsca:

1. plik konfiguracyjny config_extended.php traktowany jako ustawienia domyślne

2. plik konfiguracyjny config.php: ustawienia własne oraz nadpisanie ustawień domyślnych

3. (zdecydowana większość) przechowywana w bazie danych mySQL w tabeli config (z ewentualnych prefixem)

Utworzenie bazy danych

Przed przystąpieniem do pierwszego uruchomienia potrzebna jest baza danych:

CREATE TABLE phplistdb;
CREATE USER 'phplistuser'@'localhost' IDENTIFIED BY '*********';
GRANT ALL ON phplistdb.* TO 'phplistuser'@'localhost';

FLUSH PRIVILEGES;

Plik konfiguracyjny

Przed przystąpieniem do pierwszego uruchomienia (w przeglądarce) należy ustawić pewne parametry w pliku konfiguracyjnym, tak aby utworzona baza danych oraz wpisane do niej wartości były już poprawne.

// what is your Mysql database server hostname
$database_host = 'localhost';

// what is the name of the database we are using
$database_name = 'phplistdb';

// what user has access to this database
$database_user = 'phplistuser';

// and what is the password to login to control the database
$database_password = '***********';

// Ustawienia dla phpmailer
define('PHPMAILERHOST', 'mx1.bsdserwis.com');
define('PHPMAILERPORT',587);
define("PHPMAILER_SECURE",'tls');
define('PHPMAILER_SMTP_DEBUG', 0);
$phpmailer_smtpuser = 'smtpuser';
$phpmailer_smtppassword = 'smtpauthpassword';

// Zwrotki
$message_envelope = 'biuletyn.zwrotki@uniquework.pl';

// set this to 0, if you set up a cron to download bounces regularly by using the
// commandline option. If this is 0, users cannot run the page from the web
// frontend. Read README.commandline to find out how to set it up on the
// commandline
define('MANUALLY_PROCESS_BOUNCES', 1);

// when the protocol is pop, specify these three
$bounce_mailbox_host = 'pop3.bsdserwis.com';
$bounce_mailbox_user = 'zwrotki@domena.tld';
$bounce_mailbox_password = '***************';
$bounce_mailbox_port = '995/pop3/ssl';

// set this to 0 if you want to keep your messages in the mailbox. this is potentially
// a problem, because bounces will be counted multiple times, so only do this if you are
// testing things.
$bounce_mailbox_purge = 1;

$default_system_language = "pl";
$pageroot = '';
$table_prefix = '';
$usertable_prefix = '';

Ustawienie uprawnień do wybranych katalogów

chown -R www /usr/local/www/phplist/lists/admin/plugins
chown www /usr/local/www/phplist/lists/config
chown www /usr/local/www/phplist/lists/images

# katalog, który trzeba podać w konfiguracji phpList (menu Config)
for d in image files flash; do mkdir -p /var/www/htdocs/virtuals/nowosci-media/public/$d; done
chown -R www /var/www/htdocs/virtuals/nowosci-media/public

Konfiguracja zadań crontab

TBA

Katalog na media do wiadmości newslettera

• W celu załączania zdjęć czy innych obiektów multimedialnych w tworzonych wiadomościach, konieczne jest podanie adresu URL do nich. W tym celu został uruchomiony specjalny katalog (mapowany jako https://nowosci.doamain.tld/media/), do którego należy takie materiały umieszczać. Katalog jest dostępny poprzez FTP:

ftp://__user__:__haslo__@nowosci.domain.tld

Pliki, które mają być widoczne z poziomu przeglądarki należy umieścić w katalogu public/.

Można również wykorzystać mechanizm "katalogu zewnętrznego" w ownCloud lub nextCloud

Konfiguracja nginx

Konfiguracja nginx najlepiej wykonać jako root dla danej domeny. Przykładowa konfiguracja:

server {
# [...]
    root /usr/local/www/phplist/lists;
    index index.php;

    location /.well-known/ {}

    location /media/ {
        alias /var/www/htdocs/virtuals/nowosci-media/public/;
        index index.html;
    }
# [...]
}

Tips and tricks

1. Jeżeli panel webowy nie wyświetla się w pełni w języku polskim, to może być konieczne przelogowanie. Oczywiście trzeba się upewnić, że zostały pobrane aktualne tłumaczenia (jedna z pozycji menu konfiguracji).

2. W wersji 3.4.0 na sztywno jest ustawione sprawdzanie, czy katalog /admin/ nie jest dostępny (poprzez konfigurację nginx) w inny sposób. Być może w kolejnych wersjach będzie możliwa zmiana (czy przysłonięcie) panelu administracyjnego pod inny URL.

Źródła w sieci internet

1. phplist

2. Dokumentacja phpList

Odnośniki do dokumentacji

1. nginx

2. mySQL

3. repozytroium pakietów

4. ownCloud

5. nextCloud

 (c) 2004 - 2026 BSD Serwis Krzysztof Stryjek. W przypadku błędów, poprawek proszę kontaktować się z administratorem wiki.