Skrypt bazy nieruchomoś ci HOLMES v1.0

Skrypt bazy nieruchomości HOLMES v1.0
Created by Kamil Wyremski – wyremski.pl
Opis skryptu:
Skrypt umożliwia stworzenie swojej własnej bazy nieruchomości. 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 Map 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
/upload/images
/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]
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/?action=settings_payments
4.
5.
6.
7.
8.
9.
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
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/?action=settings w pole „Google Mapy API” ->
w ustawieniach Google klikamy na „Done”
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/?action=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”
Przypadkowo zmieniłem język witryny, jak wrócić do języka polskiego?
Należy przejść pod adres http://nazwa_domeny/cms/?action=settings i w trzecim polu od góry
wybrać właściwy język
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.
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 wartość $settings['cms_test_mode'] na true
Baza danych jest prawidłowo podłączona jednak nie można nic zapisać w skrypcie
Powodem może być włączenie trybu STRICT_TRANS_TABLES na serwerze MySQL. Aby skrypt
poprawnie działał tryb sql_mode nie może mieć wartości STRICT_TRANS_TABLES. Proszę
skontaktować się z administratorem serwera aby wyłączył ten tryb.
Zrzuty ekranu: