Skrypt katalogu firm EMPRESA v1.0 Created by Kamil Wyremski wyremski.pl Opis skryptu: Skrypt umożliwia stworzenie swojej własnej bazy katalogu firm. Posiada wbudowaną zaawansowaną wyszukiwarkę oraz dużą ilość opcji przydatnych przy dodawaniu ofert. Administrator strony ma do dyspozycji panel administracyjny (CMS), w którym może dokonywać zmian wielu opcji konfiguracyjnych. Strona dostępna jest w kilku wersjach językowych, istnieje możliwość szybkiej zmiany języka. Główne cechy: Duża ilość opcji przy dodawaniu i edycji ofert Zaawansowana wyszukiwarka ofert Możliwość zaznaczenia lokalizacji na Mapie Google oraz wyszukiwania w podanej odległości Wyświetlanie preferowanych lokalizacji z Mapy Google Możliwość promowania ogłoszeń przez administratora lub przez system płatności DotPay Responsywny szablon oparty na Twitter Bootstrap v3.3.6; strona jest poprawnie wyświetlana na wszystkich urządzeniach mobilnych Skrypt jest zoptymalizowany, dzięki czemu strony wyświetlają się bardzo szybko bez dużego obciążenia serwera Skrypt wspiera wersje obcojęzyczne, dołączone są następujące języki: polski, angielski, niemiecki, francuski, hiszpański, rosyjski, włoski. Istnieje możliwość zmian w tekstach oraz dodania nowych języków Integracja z portalami społecznościowymi (np. panel Facebook, logowanie przez Facebook-a, przyciski Lubię to, Udostępnij, Tweetnij, +1 i Wykop ) Duża ilość miejsc na reklamy Możliwość edycji stron informacyjnych Możliwość dodawania artykułów (prowadzenia bloga) na stronie W wersji instalacyjnej dołączony uniwersalny regulamin i polityka prywatności Kanał RSS z najnowszymi ofertami Możliwość automatycznego dodawania znaku wodnego do zdjęć w ofertach Dodawanie ofert przez niezalogowanych użytkowników Mikrodane (microdata) przydatne przy pozycjonowaniu witryny, więcej informacji dostępne pod adresem: https://www.w3.org/tr/microdata/ Zabezpieczenia, m.in. solenie haseł, kod sesji logowania oraz dodawania ogłoszeń, dodawanie atrybutów nofollow w linkach w opisach ogłoszeń Łatwa instalacja systemu dołączony program instalacyjny Bardzo rozbudowany system CMS (Panel Administratora), pozwalający na pełną edycję strony oraz ustawień systemu Automatycznie tworzona mapa witryny (poprzez zadania cron-a) Wymagania: serwer z PHP w wersji min. 5.4 oraz z bazą danych MySQL i to wszystko!
Wymagania skryptu: Skrypt wymaga jedynie PHP w wersji min 5.4 oraz bazy danych MySQL. Sam skrypt zajmuje na serwerze ok. 10 MB. Wymagania co do szybkości serwera są ściśle zależne od domeny, na której zostanie zainstalowany skrypt i od tego, jak duży jest na niej ruch (ilość sesji/użytkowników). Instalacja skryptu: Po rozpakowaniu archiwum z plikami strony kopiujemy je bezpośrednio do głównego katalogu na serwerze lub koncie ftp. Po wejściu na adres domeny powinien pokazać się program instalacyjny (bezpośredni adres do niego to: http://nazwadomeny.pl/install). Wypełniamy wszystkie pola wpisując dane do bazy danych: serwer (domyślnie localhost), numer portu (domyślnie 3306 lub 3307), nazwę użytkownika, hasło, nazwę bazy, następnie dane związane z systemem CMS, czyli login i hasło jakich chcemy używać przy logowaniu do CMS-a (można je później zmienić). W pole Email administratora należy wpisać email, który będzie użyty w formularzu kontaktowym oraz w charakterze nadawcy wiadomości email. Można go później zmienić w CMS-ie, pole jest obowiązkowe. W pole Prefiks tabel w bazie danych należy wpisać prefiks tabel w bazie danych w przypadku gdy np. do jednej bazy podłączamy kilka różnych witryn zapobiega to nadpisaniu tabel o takich samych nazwach. W przypadku gdy baza danych używana jest tylko do tej witryny pole można zostawić puste. W pole Sól do haseł w systemie możemy wpisać dowolny ciąg znaków które będą dopisywane do haseł użytkowników, a następnie kodowane funkcją md5. Służy to jako dodatkowe zabezpieczenie haseł użytkowników na wypadek gdyby ktoś niepowołany dostał się do bazy danych. Ustawienie to zapisywane jest w pliku config/config.php i można je później zmienić (oczywiście po zmianie żaden użytkownik nie będzie mógł się zalogować do systemu, będzie musiał skorzystać z resetu hasła). Pole można zostawić puste, jednak zalecane jest dopisanie dowolnego ciągu znaków. Hasła do systemu CMS nie korzystają z solenia. Klikamy Zapisz, program instalacyjny powinien stworzyć odpowiednie tabele w bazie danych, nadpisać plik config/db.php oraz ustawić prawidłowe prawa dostępu dla kilku folderów. W razie problemów przy instalacji i braku komunikatów należy zmienić uprawnienia następujących plików i folderów na wartość 0777: /cache /cms/cache /cms/tmp /upload/images /upload/photos /tmp /sitemap.xml /config/db.php - w tym ostatnim po zakończonej instalacji należy zmienić na domyślne (czyli 0644) Po zakończeniu instalacji należy usunąć folder /install z serwera
W folderze /config znajdują się dodatkowe pliki: - db - default.php domyślny plik db.php dla instalacji serwisu, wymusza uruchomienie instalacji (należy usunąć istniejący plik db.php i zmienić nazwę tego pliku na db.php) - db ready.php w przypadku gdy chcemy podłączyć serwis do istniejącej bazy danych należy użyć tego pliku, zawiera on wstępnie skonfigurowany plik db.php w którym należy wypełnić pola dotyczące podłączenia do bazy danych (należy usunąć istniejący plik db.php i zmienić nazwę tego pliku na db.php) Ważne! W przypadku gdy w Panelu Administracyjnym naszego serwera/hostingu zostało ustawione, żeby domena zaczynała się od przedrostka www należy z pliku.htaccess usunąć następujące 2 linijki: RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC] RewriteRule ^(.*)$ http://%1%{request_uri} [R=301,QSA,NC,L] Link do filmiku na YouTube: https://www.youtube.com/watch?v=yoyhyjo8qrc Cron: System do prawidłowego działania potrzebuje skonfigurowania zadań cron-a dla pliku cron-daily.php znajdującego się w głównym katalogu serwisu. Należy ustawić go, aby uruchamiał się raz dziennie, w nocy, koniecznie po północy. Może się uruchamiać kilkakrotnie w ciągu doby bez żadnych skutków ubocznych. CMS (Panel Administracyjny): Po instalacji skryptu CMS jest on dostępny pod adresem http://nazwadomeny.pl/cms, gdzie nazwadomeny.pl to domena, pod którą jest zainstalowany skrypt. Login i hasło takie jak zostały podane przy instalacji systemu. Przy pięciokrotnym podaniu nieprawidłowego loginu lub hasła logowanie zostaje zablokowane dla danego adresu IP na 30 minut. Najczęściej zadawane pytania: 1. Jak zmienić język instalacji? Po uruchomieniu programu instalacyjnego wybierz z menu Select language preferowany język. 2. Po skopiowaniu plików na serwer (lub już po instalacji) wyświetla się biała strona Proszę sprawdzić uruchomioną wersję PHP na serwerze. Minimalna wersja PHP, która jest obsługiwana przez skrypt to PHP 5.4 3. Jak uruchomić płatności DotPay? Serwis umożliwia promowanie ogłoszeń opłacanych przez system DotPay. Aby uruchomić płatności DotPay musimy mieć aktywowane konto w DotPay. Następnie przechodzimy do panelu logowania: https://ssl.dotpay.pl/enter W menu, w dziale Płatności internetowe wybieramy pozycję kody dostępu -> Dodaj nowe konto -> wybieramy pozycję Konto kodów bezobsługowych i klikamy Dalej -> wpisujemy nazwę usługi (dowolna), jako IP serwera sprawdzającego kody wpisujemy wartość *.*.*.* (dowolny serwer), wpisujemy identyfikator konta (dowolny), wybieramy wartość kodu (dowolna, waluta musi być zgodna z walutą wybraną w serwisie) oraz czas ważności kodu
(dowolna, oznacza po maksymalnie jak długim czasie kod można wykorzystać w serwisie po jego otrzymaniu). Klikamy Dalej. Zostanie wygenerowany link do płatności. W nowej karcie otwieramy adres: http://nazwa_domeny.pl/cms/?module=settings_payments Zaznaczamy pole Promuj przez DotPay. W pole Koszt promowania wpisujemy wybraną wartość kodu, w pole DotPay ID wpisujemy nasz ID z systemu DotPay (używany podczas logowania), w pole DotPay Code wpisujemy wybrany przez nasz identyfikator konta w DotPay a w pole DotPay URL kopiujemy wygenerowany przez DotPay link do płatności. Płatności DotPay zostały uruchomione Link do filmiku na YouTube: https://www.youtube.com/watch?v=wvvvefvqh6u 4. Nie wyświetla się Mapa Google / Skąd mam wziąć Google Maps API? Aby uruchomić Mapę Google w serwisie należy posiadać klucz Google Maps API. Po zalogowaniu w Google przechodzimy pod adres: https://console.developers.google.com/apis/dashboard Z menu po lewej u góry wybieramy pozycję Create project, wpisujemy nazwę projektu -> Create -> Enable API -> wybieramy Google Maps JavaScript API -> Enable -> Go to Credentials -> jako platformę wybieramy Web browser (JavaScript) -> What credentials do I need? -> w pole Name wpisujemy nazwę projektu (dowolna) -> w pole Accept requests from these HTTP referrers (web sites) wpisujemy adres URL na którym jest zainstalowany skrypt noclegowy -> klikamy na Create API key -> zostanie wygenerowany kod API key który należy wkleić w ustawieniach skryptu: http://nazwa_domeny.pl/cms/?module=settings w pole Google Mapy API - > w ustawieniach Google klikamy na Done Link do filmiku na YouTube: https://www.youtube.com/watch?v=nrt0-yuqoiq 5. Jak uruchomić logowanie przez Facebook-a? Będąc zalogowanym na swoim koncie Facebook przechodzimy pod adres: https://developers.facebook.com/ W górnym prawym rogu z menu wybieramy pozycję Dodaj nową aplikację -> Strona internetowa -> Wpisujemy nazwę naszej aplikacji (dowolna) i klikamy na Create new Facebook App ID -> Wpisujemy email kontaktowy oraz wybieramy kategorię (dowolna) -> Create App ID -> w górnym prawym rogu klikamy na Skip Quick Start Otworzy się okno edycji aplikacji na Facebook-u. Z menu po lewej stronie wybieramy Ustawienia i w polu App Domains wpisujemy domenę naszej strony. Następnie klikamy na Dodaj platformę - > Strona internetowa i w polu Site URL ponownie wpisujemy adres URL naszej strony ze skryptem. Klikamy na Zapisz zmiany. Następnie z menu po lewej stronie wybieramy Recenzja aplikacji i pod górnym napisem Udostępnić aplikację publicznie? wybieramy Tak, zapisujemy zmiany. Następnie w drugim oknie przeglądarki wchodzimy w ustawienia portali społecznościowych naszego skryptu: http://nazwa_domeny.pl/cms/?module=settings_social_media I kopiujemy z Facebook-a wartość z pola Identyfikator aplikacji do pola Facebook API oraz z pola Klucz tajny aplikacji do pola Facebook Secret Zaznaczamy także pole Zezwól na logowanie przez Facebook-a Link do filmiku na YouTube: https://www.youtube.com/watch?v=qqophfhklaw 6. W czasie próby zalogowania przez FB wyświetla komunikat Aplikacja nieskonfigurowana: Ta aplikacja jest jeszcze w trybie deweloperskim Należy wyłączyć tryb deweloperski aplikacji. Będąc zalogowani na Facebook-u, przechodzimy pod adres: https://developers.facebook.com/ Z menu po prawej stronie wybieramy naszą aplikację, wybieramy z menu App review a następnie pod Make [application name] public? zaznaczamy Yes. Powinien się wyświetlić komunikat Your app is currently live and available to the public 7. Przypadkowo zmieniłem język witryny, jak wrócić do języka polskiego? Należy przejść pod adres http://nazwa_domeny/cms/?module=settings i w trzecim polu od góry wybrać właściwy język 8. Chciałbym dodać / poprawić język, jak to zrobić? Wszystkie wersje językowe dostępne są w katalogu /config/langs
Aby zmienić teksty w istniejącym języku należy otworzyć istniejący plik PHP, a następnie wyszukać wiersz z szukanym słowem lub zdaniem. Aby dodać nowy język wystarczy skopiować plik z istniejącym językiem a następnie ręcznie przetłumaczyć wszystkie teksty znajdujące się w nim. Link do filmiku na YouTube: https://www.youtube.com/watch?v=e6mfczigntc 9. Co to jest tryb testowy CMS i jak go włączyć? Tryb testowy CMS (tryb pokazowy CMS) deaktywuje w CMS-ie wszystkie funkcje edycyjne oprócz zmiany szablonu i języka. Może być używany do pokazania funkcjonalności systemu. Uruchamia się go w pliku config/config.php zmieniając define('_cms_test_mode_', false); na define('_cms_test_mode_', true); 10. W statystykach nie są uwzględniane usunięte już ogłoszenia oraz usunięci użytkownicy Statystyki w systemie CMS uwzględniają tylko obecnie dodane ogłoszenia i zarejestrowanych użytkowników. Podczas ich usuwania statystyki wyświetleń, logowań itd. się zmniejszają. Ma to na celu utrzymanie maksymalnej wydajności systemu (wszystkie dane powiązane z ogłoszeniami są usuwane z bazy danych) 11. Po instalacji nie działają linki podstron (m.in. do logowania, dodawania ogłoszeń) Proszę się upewnić czy wszystkie pliki strony zostały poprawnie wgrane na serwer, najlepiej spróbować wgrać je ponownie. Proszę także sprawdzić czy w głównym katalogu strony znajduje się plik.htaccess (jest to plik bez nazwy, ma tylko rozszerzenie) a na serwerze jest włączony mod rewrite. 12. Reset loginu i hasła do systemu CMS W przypadku gdy nie są znane dane do systemu CMS należy ustawić nowy login i hasło bezpośrednio w tabeli w bazie danych. W tym celu logujemy się do PhpMyAdmin do bazy danych podłączonej do skryptu, następnie w tabeli cms (lub prefiks_tabel-cms) przy nazwie naszego użytkownika klikamy na edytuj, w pole username wpisujemy nasz nowy login, w pole password hasło i zaznaczamy przy polu password funkcje MD5. Po tym klikamy na Wykonaj. W bazie zostaną zapisane nowe dane do systemu CMS którymi możemy się do niego logować. Zrzuty ekranu: