INSTRUKCJA INSTALACJI I KONFIGURACJI APLIKACJI WEBSOFT MAILER 2.2.0 Producent: Lukaszjarosinski.com Nazwa oprogramowania: Websoft Mailer 2.2.0 Wersja finalna: 20.02.2013 Kontakt: lukaszjarosinski@gmail.com, tel. 508 052 990 Wymagania techniczne: PHP5, MySQL >= 5, obsługa.htaccess, mod_rewrite, GD2, wyłączone register_globals, dostęp do serwera poczty wychodzącej (SMTP) INSTALACJA I KONFIGURACJA OPROGRAMOWANIA 1) Należy wgrać wszystkie pliki na serwer do wybranego katalogu/podkatalogu. 2) Należy założyć na serwerze bazę danych oraz ewentualnie użytkownika dla niej (jeżeli jest to na danym serwerze wymagane) potrzebne będą takie dane, jak: nazwa hosta bazy danych (zwykle localhost), nazwa bazy danych, nazwa użytkownika bazy danych oraz jego hasło. Należy przygotować również tzw. frazę szyfrującą jest to dowolny ciąg znaków, który posłuży do szyfrowania haseł (np. 812jeu20k3). 3) Wpisujemy w przeglądarce adres oprogramowania, np. http://www.twojadomena.pl jest to jedynie przykład, a w zależności od serwerów i użytkownika adres ten może się całkowicie różnić. 4) Wypełniamy formularz danymi z pkt 2. Po zatwierdzeniu danych, przy założeniu, że wszystkie są poprawne, system zostaje zainstalowany i wstępnie skonfigurowany do pracy. 5) Chcąc wejść do panelu administracyjnego, należy wejść na adres z pkt 3 dopisując na końcu /admin oraz podać dane dostępowe (domyślnie nazwa użytkownika oraz hasło to admin - należy je zmienić po zalogowaniu się do panelu) 6) Usuwamy plik install.php z serwera 7) Chcąc wejść do panelu administracyjnego, należy wejść na adres z pkt 3 oraz podać dane dostępowe (domyślnie nazwa użytkownika oraz hasło to admin - należy je zmienić po
zalogowaniu się do panelu). 8) Oprogramowanie jest przeznaczone zarówno do pracy ręcznej (ręczne uruchamianie z panelu administracyjnego, tzw. wysyłanie mailingu na żądanie), jak i automatycznej (sam rozsyła wiadomości i pracuje nawet przy wyłączonym komputerze) korzysta wtedy z harmonogramu zadań CRON. Jeżeli chcemy przejść w tryb pracy automatycznej, należy skonfigurować harmonogram zadań CRON (pkt 9). 9) Sposób ustawienia harmonogramu zadań CRON jest różny w zależności od serwera i stosowanego na nim oprogramowania. Aby ustawić parser, należy do CRONa dodać wykonywanie pliku http://www.twojadomena.pl/sendmails.php. Częstotliwość uruchamiania plików zależy od serwera, jego mocy itd. - Optymalnym ustawieniem jest uruchamianie skryptów nie rzadziej, niż co 10 minut. W większości przypadków do harmonogramu należy dodać następujące komendy: GET http://www.twojadomena.pl/sendmails.php >/dev/null lub lynx -dump http://www.twojadomena.pl/sendmails.php Jeżeli podane powyżej komendy nie działają, należy spróbować innej, np. jednej z poniższych: Być może dany serwer nie potrafi obsłużyć komendy podanej powyżej, wtedy można spróbować innej. Np. jednej z poniższych: lynx -dump XXXXXXX /usr/bin/lynx -dump XXXXXXX wget -q -O /dev/null XXXXXXX /usr/bin/wget -q -O /dev/null XXXXXXX /usr/local/bin/php YYYYYYY &>/dev/null gdzie: XXXXXXX to adres URL pliku wysyłającego mailing (np. http://www.twojadomena.pl/sendmails.php), YYYYYYY ścieżka dostępu do pliku parsera (ścieżka bezwględna z katalogu root na serwerze). Jeśli zadania CRON nadal nie są uruchamiane, to sprawdź, czy w katalogu powyżej katalogu, w którym zainstalowany jest Websoft Mailer nie ma pliku.htaccess, który blokuje
dostęp do plików parsera. Uruchamianie zadań CRON na serwerach home.pl Aby ustawić wywoływanie zadań crona na serwerach home.pl należy: 1. Utworzyć plik o nazwie cron-10min.php 2. W pliku tym wpisać kod: <?php echo file_get_contents('xxxxxxx');?> gdzie XXXXXXX to adres URL pliku wysyłającego mailing (np. http://www.twojadomena.pl/sendmails.php). 3. Przegrać plik do katalogu GŁÓWNEGO serwera wirtualnego home.pl. Uruchamiane zadań CRON na serwerach nazwa.pl Serwery nazwa.pl to jedyne serwery, których nie polecamy, ponieważ można na nich uruchamiać komendy CRONa jedynie co 1 godzinę. Na większości serwerów zadania CRONa można uruchamiać nawet co 1 minutę (optymalnie dla naszego skryptu to 15 minut). Jeśli zainstalowaliśmy Websoft Mailer na serwerze nazwa.pl, to obejściem powyższego ograniczenia jest wywoływanie zadań CRON z innego serwera. Wtedy na innym serwerze możemy zdefiniować jako komendę CRONa (tak jak przedstawiono powyżej). 10) Oprogramowanie ma możliwość pracy automatycznej. Ustawieniem zalecanym jest uruchamianie wysyłania co 15 minut. Jeżeli jednak dysponujemy serwerem o dużej mocy (np. serwer dedykowany) w celu przyspieszenia pracy skryptu i rozsyłania wiadomości, możemy zmienić dwa parametry: częstotliwość uruchamiania pliku wysyłającego maile (pkt 9) oraz liczbę maili wysyłanych podczas jednego uruchomienia parsera w jednej paczce (domyślnie 50 maili). Aby zmienić liczbę wysyłanych maili, należy edytować plik config.php znajdujący się na serwerze. Wiersz 34 odpowiada za to ustawienie. UWAGA! Zmieniając ustawienia domyślne należy mieć na uwadze, że serwery poczty wychodzącej zapobiegając rozsyłaniu spamu często blokują dużą liczbą połączeń następujących po sobie. Jeżeli posiadasz własny serwer SMTP możesz dowolnie ustawiać liczbę maili wysyłanych w jednej paczce oraz częstotliwość uruchamiania skryptu
rozsyłającego maile. Szczegółowych informacji o liczbie maili możliwych do wysłania dostarcza obsługa techniczna serwera, na którym jest zainstalowane oprogramowanie. 11) Wymagania techniczne: Obsługa PHP5 Baza danych MySQL w wersji co najmniej 5 Obsługa.htaccess Obsługa skróconych linków mod_rewrite Zainstalowania biblioteka GD2 do przetwarzania obrazów Wyłączone register_globals Dostęp do serwera poczty wychodzącej (SMTP) skrypt działa z większością serwerów pocztowych w Polsce (w tym bezpłatnych) Obecnie większość dostępnych na rynku hostingów spełnia te wymagania. UŻYWANIE WEBSOFT MAILER 2.0.0 Po zalogowaniu do panelu administracyjnego systemu mailingowego użytkownik ma do dyspozycji kilka zakładek. Poniżej zostanie omówiona każda z nich. Zarządzanie użytkownikami/dodaj użytkownika użytkowników w tym przypadku należy rozumieć jako osoby mogące tworzyć kampanie reklamowe, dodawać adresatów, planować wysyłki itd. Są to administratorzy, mający dostęp do panelu administracyjnego oprogramowania. Dodając takiego użytkownika lub edytując go należy zwrócić szczególną uwagę na podanie prawidłowej nazwy użytkownika i hasła podanie błędnych danych uniemożliwi zalogowanie się do panelu administracyjnego przez danego użytkownika. Pozostałe informacje są jedynie informacjami dodatkowymi i nie są konieczne do podawania. Warto jednak ustawić Przyjazną nazwę w takim przypadku panel administracyjny będzie wyświetlał tą nazwę po zalogowaniu, czyniąc oprogramowanie spersonalizowanym. Dodaj grupę adresatów/zarządzaj grupami adresatów grupy adresatów są pewnymi zbiorami adresatów, do których można skierować daną kampanię. Baza danych odbiorców może być tym samym posegregowana według różnych kryteriów, np. branż w których działają firmy, do których wysyłamy wiadomość. Żeby stworzyć grupę adresatów należy wpisać jej nazwę (ważne przy tworzeniu kampanii) oraz wybrać adresatów, którzy mają znaleźć się w tej grupie. Jeden adresat może być dodany do wielu grup. Przy tworzeniu/edycji grupy można filtrować adresatów wg dowolnego kryterium z bazy (imię, nazwisko, słowo kluczowe, adres e-mail). Chcąc wyszukać wszystkie adresy mailowe rozpoczynające się od A należy po słowie A dodać +, czyli a+. Analogicznie chcąc odnaleźć adresy kończące się na A fraz ma wtedy postać +a. Edycja grup
polega na wypełnianiu identycznego formularza, jak przy tworzeniu nowej grupy. Dodaj adresata/zarządzaj adresatami adresat jest pojedynczym użytkownikiem, do którego możemy wysłać wiadomość. Dodanie adresata sprowadza się do podania informacji o nim, tj. imienia i nazwiska, adresu e-mail oraz krótkiego opisu, po którym można wyszukiwać adresata, np. branży, w której działa; należy też określić, czy adresat jest aktywny (można do niego wysyłać wiadomości) czy nie (mimo obecności w bazie danych żadne wiadomości nie są do niego wysyłane. Edycja jest równie prosta. Import adresatów z pliku CSV w celu uniknięcia ręcznego wprowadzania każdego adresata, system został wyposażony w mechanizm importu adresatów z pliku CSV. Pliki CSV są plikami tekstowymi, które umożliwiają przechowywanie w nich różnych danych, a następnie ich odczyt/obróbkę w arkuszu kalkulacyjnym, np. Excel. Wykorzystując ten format można w prosty i szybki sposób stworzyć bazę danych użytkowników, gdzie każde pole opisujące użytkownika będzie w osobnej kolumnie, np. imię w kolumnie A, nazwisko w kolumnie B itd. Chcąc zaimportować adresatów do systemu, można przy pomocy programu Excel stworzyć ich bazę według schematu: kolumna A imię, kolumna B nazwisko, kolumna C e-mail, kolumna D opis, kolumna E czy aktywny (0 oznacza nie, 1 oznacza tak). Zapisując plik należy zwrócić uwagę na sposób rozdzielania pól (musi być ustawiony ; - średnik). Następnie przy pomocy mechanizmu importu klikamy przycisk Przeglądaj... wgrywając tym samym plik na serwer resztą zajmie się generator importu, baza danych zostanie uzupełniona zaimportowanymi danymi użytkowników. Wyciągnij adresy z dowolnego pliku system posiada wbudowany mechanizm przeszukiwania plików w dowolnym formacie w celu odnalezienia wszystkich adresów e-mail z w nich występujących. Dzięki temu można w szybki sposób stworzyć bazę danych adresatów bez potrzeby ręcznego wpisywania każdego adresu e-mail do Excela bądź bezpośrednio do systemu. Wystarczy przy pomocy tej zakładki wgrać dowolny plik na serwer, a skrypt sam wyszuka w nim wszystkie adresy e-mail i uzupełni nimi bazę danych. Funkcja jest szczególnie przydatna przy importowaniu adresów mailowych z plików HTML, stanowiących kopie zapisanych stron internetowych zawierających np. adresy e-mail. Uwaga! Funkcja importuje jedynie adresy e-mail, nie importuje imion, nazwisk itd. - te dane należy uzupełnić ręcznie. Konfiguracja zakładka umożliwia zmianę liczby maili wysyłanych przy jednym uruchomieniu oraz innych parametrów dotyczących pracy oprogramowania. Uwaga! Należy zwrócić uwagę, żeby dane wpisywać jako liczby, bez spacji, przecinków i innych znaków to może uniemożliwić dalsze korzystanie z oprogramowania. Stwórz kampanię/zarządzanie kampaniami kampania w tym przypadku oznacza wysyłkę
mailingu. Żeby zaplanować sobie wysyłkę mailingu, należy podać temat wiadomości, jej treść, wybrać grupę adresatów do której wiadomość ma być wysłana, datę rozpoczęcia wysyłki. Należy również określić serwer SMTP, z którego przy wysyłce skrypt ma korzystać, a także nazwę użytkownika tego serwera, jego hasło oraz port, na jakim skrypt może łączyć się z serwerem. Każdy rozsyłany mailing może korzystać z innego serwera SMTP, dzięki czemu możemy zaplanować kilka całkowicie różnych i niepowiązanych ze sobą kampanii mailingowych. Poza tym należy określić, z jakiego adresu mailowego wiadomość zostanie wysłana, oraz co pokaże się w polu Od wiadomości. Uwaga! Niektóre serwery SMTP nie dają możliwości wpisania adresu mailowego nadawcy mailingu innego, niż nazwa użytkownika SMTP należy mieć to na uwadze przy tworzeniu kampanii, gdyż w przypadku błędnych ustawień mailing nie zostanie wysłany! Z każdej kampanii jest na bieżąco tworzony raport liczby wysłanych/nie wysłanych wiadomości. Po zakończeniu wysyłki można ponownie dodać daną kampanię do kolejki wysyłania funkcja przydatna przy cyklicznych kampaniach. Tworząc jedną kampanię a następnie kopiując ją można zaplanować wysyłkę jednej wiadomości do tych samych użytkowników np. co miesiąc. Każda wiadomość może być też inna wystarczy zmienić tylko treść, a nie trzeba będzie tworzyć od nowa całej kampanii. System mailingowy zawiera również możliwość personalizacji każdej wiadomości imieniem, nazwiskiem lub adresem e-mail adresata. Aby skorzystać z tej funkcji, w treści wiadomości należy podać frazę ##imie## - zostanie ona zastąpiona imieniem adresata; ##nazwisko## - wstawi nazwisko adresata; ##email## - wstawi adres e-mail adresata. Personalizacja odbywa się bezpośrednio przy wysyłce, podane frazy są na bieżąco zastępowane odpowiednimi danymi. Uwaga! Każda wiadomość jest wysyłana osobno oznacza to, że adresat nie zobaczy pozostałych odbiorców tej samej wiadomości. Co więcej, przy odpowiednim ustawieniu personalizacji adresat nie pozna, że jest to część kampanii mailingowej potraktuje Twoją wiadomość jako indywidualną, skierowaną wyłącznie do niego. To niewątpliwie zwiększy odsetek odpowiedzi.