Skrypt strony www z ogłoszeniami online tylko dla profesjonalistów.

• Opis skryptu
• Możliwości skryptu
• Demo i zakup skryptu
• Wymagania
• Instalacja skryptu
• Konfiguracja skryptu
  • Przekierowanie na https
  • Konfiguracja reCAPTCHA
  • Zmiana języka strony
  • Logowanie przez Facebook i Google
  • Płatności
  • Zdjęcia
  • Aplikacja PWA
  • Modyfikacje na stronie
  • Aktualizacja skryptu
• Historia zmian (changelog)
• Znane problemy i ich rozwiązania

Opis skryptu

Skrypt Notice3 to nowoczesne i wszechstronne narzędzie przeznaczone do tworzenia stron internetowych z ogłoszeniami online. Można go wykorzystać w dowolnej kategorii ogłoszeń, jak również jako platformę do prezentacji nieruchomości, ofert noclegowych, ofert pracy lub jako katalog firm. Nasze doświadczenie zdobyte podczas tworzenia innych skryptów, takich jak Notice2, Holmes2, Festa2, oraz nasza interakcja z klientami prowadzącymi własne serwisy, zaowocowały stworzeniem skryptu, który najlepiej odpowiada potrzebom użytkowników i jego właściciela.

Dzięki Notice3 masz możliwość stworzenia portalu o zasięgu lokalnym, ogólnopolskim lub międzynarodowym. Rozbudowany panel administracyjny ułatwi Ci zarządzanie stroną i dostosowanie jej do własnych potrzeb. Notice3 został napisany z uwzględnieniem optymalizacji i pozycjonowania stron internetowych, co umożliwia szybkie osiągnięcie wysokiej widoczności w wynikach wyszukiwarek internetowych.

Skrypt oparty jest na frameworku Symfony 6 i zastosowano w nim zasadę MCV. Po stronie front-endu wykorzystano technologie VUE oraz Bootstrap 5.

Notice3 to narzędzie przeznaczone do profesjonalnych zastosowań, idealne do tworzenia dużych serwisów z ogłoszeniami online. Dzięki zastosowaniu podejścia MCV i oparciu o framework Symfony, jest on łatwy do rozbudowy i charakteryzuje się znakomitą wydajnością.

Notice3 oferuje między innymi następujące możliwości:

• Rejestrację użytkowników, logowanie i resetowanie hasła, a także przydzielanie ról moderatora oraz administratora. Formularze są zabezpieczone przez reCAPTCHA.
• Logowanie poprzez konta Facebook i Google.
• Możliwość dodawania ogłoszeń oraz ich wyszukiwaia. Użytkownicy mogą również dodawać ogłoszenia do schowka.
• Opcję płatnego wystawiania i promowania ogłoszeń, z integracją z Przelewy24, PayPal, HotPay, TPay, Payu, Blue Media oraz możliwość dokonywania płatności przelewem bankowym.
• Wykorzystanie mapy Google do zaznaczania lokalizacji ogłoszeń.
• System wewnętrznych wiadomości między użytkownikami.
• Możliwość prowadzenia bloga na stronie oraz dodawania stron statycznych.
• Zarządzanie wielopoziomową listą kategorii oraz regionów, z możliwością dodawania filtrów dla danej kategorii, np. w kategorii „Samochody Osobowe” można dodać filtry takie jak rocznik i przebieg, a w kategorii „Nieruchomości” ilość pięter i metraż.
• Możliwość zmiany języka strony (strona może obsługiwać jedno wybrane język).
• Wysyłanie mailingu do zarejestrowanych użytkowników lub osób zapisanych w newsletterze.
• Tryb jasny / ciemny (dark mode).
• Możliwość zapisu do newslettera.
• Wysyłkę wiadomości z formularzy kontaktowych.
• Dostęp do statystyk serwisu w panelu admina wraz z wykresami.
• Generowanie sitemap (mapy strony).
• Udostępnianie linku do kanału RSS FEED.
• Dodawanie komentarzy do ogłoszeń przez zalogowanych użytkowników.
• Dodawanie komentarzy do wpisów blogowych i stron profilu przez pośrednictwo Facebooka.
• Przycisk umożliwiający kontakt przez Messenger na stronie ogłoszenia.
• Generowanie własnej aplikacji PWA dla portalu.
• Możliwość dodawania awatara i opisu na stronę profilu przez użytkowników.
• Ustawienie opłat w zależności od długości trwania ogłoszenia.
• Monitorowanie logów logowań, wysłanych maili, resetów haseł oraz wyświetleń ogłoszeń w panelu admina.
• Posiadanie czarnej listy adresów email i adresów IP, z których nie można dodawać ogłoszeń, a także czarnej listy słów kluczowych, które zostaną usunięte z tytułu i treści ogłoszenia.
• Podpowiedzi do wyszukiwarki ogłoszeń.
• Możliwość ukrycia kontaktu w ogłoszeniach dla niezalogowanych użytkowników.
• Możliwość zgłaszania naruszeń w ogłoszeniach przez klientów.

Demo i zakup skryptu

Aby obejrzeć demo skryptu, odwiedź stronę https://notice3.itworksbetter.net

Dane do logowania do panelu admina:
https://notice3.itworksbetter.net/admin
login: test
hasło: 1234

Jeśli interesuje Cię wersja anglojęzyczna skryptu, możesz sprawdzić demo pod adresem https://notice3en.itworksbetter.net/

Dane do logowania do panelu admina w wersji anglojęzycznej:
https://notice3en.itworksbetter.net/admin
login: test
hasło: 1234

Jeśli chcesz zakupić ten skrypt, jest on dostępny na stronie https://sklep.itworksbetter.net/skrypty-stron-www/1-skrypt-ogloszeniowy-notice3.html

Przykładowe strony stworzone przy użyciu tego skryptu to: petworld.pl, katalogofert.pl, lamusownia.pl, odsprzedaj.pl, gieldaokien.pl, trafnaokazja.pl, twojaoferta.com.pl

Wymagania skryptu

Notice3 został opracowany w oparciu o Symfony 6. Dlatego też posiada wyższe wymagania niż inne skrypty, jednak jest znacznie bardziej wydajny. Klienci, którzy zamierzają dokonywać samodzielnych zmian w serwisie, muszą posiadać bardzo dobrą znajomość PHP oraz JavaScript.

Wymagania serwera:

• PHP w wersji co najmniej 8.1. memory limit min. 512M
• Baza danych MySQL, MariaDB, PostgreSQL lub podobna.
• SSH (wiersz poleceń) z dostępem do Composera.
• Możliwość konfiguracji zadań cron poprzez polecenia PHP.
• Możliwość zmiany katalogu na który ma wskazywać domena.
• Włączony moduł MOD Rewrite.
• Symfony wymaga, aby na serwerze było dostępne polecenie proc_open oraz proc_close.

Aby sprawdzić, czy na Twoim hostingingu można zainstalować skrypt, warto przetestować możliwość instalacji Symfony, zgodnie z instrukcjami dostępnymi pod adresem https://symfony.com/doc/current/setup.html

Obsługiwane hostingi:

• Cyber Folks
• LH.pl (SSH dostępne od pakietu KIWI)
• SmartHost
• Kylos (zalecają VPS ze względu na wydajność skryptu Composera)
• dhosting (zalecają EWH)
• OVH (oferta PRO, z gwarantowaną pamięcią od oferty Performance1)
• Zenbox (Hosting Ebiznes 25k lub Hosting profesjonalny, brak możliwości ustawienia katalogu z poziomu panelu admina – zobacz niżej „Znane problemy” jak ustawić żeby domena wskazywała na katalog public, należy usunąć z disable functions open_proc i close_proc)
• AttHost (nie zaznaczaj „Odizoluj stronę” w ustawieniach strony)
• AfterMarket (od pakietu Biznes, aby zmienić katalog, na który wskazuje strona, skontaktuj się z obsługą klienta)
• Nazwa.pl (sugerują co najmniej VPS Start)
• SeoHost (należy napisać do nich żeby odblokowali SSH i odblokować proc_open i proc_close w pliku php.ini)
• Hostido (od pakietu NVME 2)

Ze względu na to, że każda firma oferuje różne wersje hostingu, zawsze zaleca się wcześniejsze upewnienie się, czy hosting obsłuży projekt oparty na Symfony 6.

Hostingi, które teoretycznie mogą obsłużyć skrypt, choć konsultanci tego nie gwarantują:

• Home.pl (SSH dostępne tylko od pakietu Biznes w górę, dostępna mała ilość pamięci, 256 lub 512 MB, niestandardowe dodawanie zadań crona, poprzez odpowiednio nazwany plik PHP)
• Hostinger (w podstawowej wersji dostępna mała ilość pamięci, maksymalnie 512 MB, wersja biznesowa działa, zobacz na dole strony „Znane problemy” jak ustawić żeby domena wskazywała na katalog public)
• az.pl (dostępna mała ilość pamięci do aktualizacji Composera, sugerują korzystanie z VPS)
• ProSerwer.pl – (pakiet PRO lub wyższy) – brak możliwości ustawienia zadania crona jako linii poleceń PHP, wymagane stworzenie kontrolera dla crona.

Nieobsługiwane hostingi:

• Kei.pl (odpowiedź konsultanta: „Zwykły hosting nie spełni wymagań, jedynie VPS”),
• WEBD.pl (mają wyłączone proc_open)

Instalacja skryptu

Instalacja skryptu przypomina instalację standardowego projektu stworzonego w Symfony 6. Pełną dokumentację frameworka znajdziesz pod adresem https://symfony.com/

Po zakupie skryptu otrzymasz archiwum z plikami. Należy je skopiować na serwer.

Domena powinna wskazywać na katalog public/ w plikach skryptu. Na przykład, jeśli wgrywasz pliki do katalogu /home/test/domains/domena.pl/public_html/ ustaw domenę, aby wskazywała na /home/test/domains/domena.pl/public_html/public/

Plik .env to główny plik konfiguracyjny systemu. Należy go skonfigurować przed rozpoczęciem użytkowania strony. Oto niektóre ważne pola w pliku .env:

APP_ENV – powinno mieć wartość „prod”

APP_SECRET – losowy ciąg znaków, można go wygenerować poleceniem app:regenerate-app-secret

MAILER_DSN – ścieżka wysyłki maili. Domyślnie ma wartość sendmail://localhost, co oznacza, że maile są wysyłane z localhost. Aby zmienić na wysyłkę przez SMTP, można ustawić np.:

MAILER_DSN=smtp://user:pass@smtp.example.com:port

Więcej informacji znajdziesz pod adresem https://symfony.com/doc/current/mailer.html

Wypełnij dane do połączenia z bazą danych. Jeśli hasło zawiera znaki specjalne, umieść je w cudzysłowiach. Oto przykład:

DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_USER=root
DATABASE_NAME=notice3
DATABASE_PASS=''
DATABASE_SERVER_VERSION=5.7

Wersja serwera bazy danych jest polem wymaganym. Wersję można sprawdzić, wykonując w bazie danych polecenie SELECT VERSION().

Więcej informacji znajdziesz pod adresem https://symfony.com/doc/current/configuration.html

APP_DEMO – czy ma być włączone demo panelu admina, domyślnie powinno być ustawione na 0

APP_URL – adres URL witryny (używany m.in. w linkach w mailach o końcu wyświetlania ogłoszenia, nie powinien zawierać znaku / na końcu)

APP_LANG – kod języka strony (domyślnie en lub pl)

Po skonfigurowaniu pliku .env, uruchom następujące polecenie w konsoli do instalacji pakietów (upewnij się, że używasz PHP w wersji co najmniej 8.1 i że jest to ta sama wersja, którą ma ustawioną domena):

composer install

Jeśli na hostingu nie masz zainstalowanego Composera, możesz skorzystać z tej instrukcji:

curl -sS https://getcomposer.org/installer | php

W takim przypadku poniższego polecenia (pod „php” na niektórych hostingach trzeba podać pełną ścieżkę do php na serwerze):

php composer.phar install

Jeśli wystąpi problem z brakiem pamięci, możesz wykorzystać następujące polecenie:

php -d memory_limit=-1 composer.phar install

Jeśli pakiety zainstalowały się poprawnie, kontynuuj do kolejnego kroku. W przypadku błędów (np. brak pamięci lub proces został zatrzymany) skontaktuj się z administratorem serwera.

Wygeneruj nowy kluczy prywatny poleceniem:

php bin/console app:regenerate-app-secret

Następnie wypełnij bazę danych, wykonując polecenie:

php bin/console doctrine:migrations:migrate

Kolejnym krokiem jest dodanie użytkownika z uprawnieniami administratora za pomocą polecenia:

php bin/console app:create-user

Skrypt zapyta o login, adres email oraz hasło. Adres email zostanie automatycznie ustawiony na adres email administratora.

Teraz możesz zalogować się do panelu administratora, dodając /admin do URL swojej domeny.

Zaleca się również skonfigurowanie kluczy reCAPTCHA, zgodnie z instrukcją

Konfiguracja crona:

Aby skonfigurować crona, należy ustawić następujące zadania crona z PHP w wersji co najmniej 8.1.

Raz dziennie po północy:

php [sciezka do strony]/bin/console cron:daily

Co 10 minut:

php [sciezka do strony]/bin/console cron:10min

Konfiguracja skryptu

Zobacz także ogólną instrukcję odnośnie konfiguracji, integracji z płatnościami i inne informacje na stronie https://blog.wyremski.pl/instrukcja-instalacji-i-konfiguracji-skryptow/

Przekierowanie na HTTPS / WWW

Jeśli Twoja strona korzysta z SSL, w pliku public/.htaccess odkomentuj (usuń znak # z początku linii) następujące dwie linie:

RewriteCond %{HTTPS} !on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Następnie w pliku .env ustaw wartość APP_URL aby zaczynała się od https.

Jeśli ustawisz APP_URL z „www” na początku, usuń te linie w pliku public/.htaccess:

RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC]
RewriteRule ^(.*)$ http://%1%{REQUEST_URI} [R=301,QSA,NC,L]

Zamiast nich wstaw:

RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ http://www.%{HTTP_HOST}/$1 [R=301,L]

Konfiguracja reCAPTCHA

Zobacz instrukcję dotyczącą uruchomienia reCAPTCHA na stronie https://blog.wyremski.pl/instrukcja-instalacji-i-konfiguracji-skryptow/#uruchomienie_recaptcha

Zmiana języka strony

Skrypt może być uruchomiony w jednym języku. Pliki z tłumaczeniami znajdują się w katalogu /translations. Kategorie, regiony i filtry muszą być ręcznie przetłumaczone w panelu administratora. Domyślny język można zmienić w pliku .env w zmiennej APP_LANG.

Jeśli ustawisz inny język niż „pl” lub „en”, pamiętaj o przetłumaczeniu adresów URL w kontrolerach (w plikach .php w katalogu /src/Controller).

Więcej informacji znajdziesz w dokumentacji https://symfony.com/doc/current/translation.html

Płatności

Aby poprawnie skonfigurować płatności przez Przelewy24, PayPal, HotPay, TPay, PayU lub Blue Media, proszę zajrzeć do instrukcji dostępnej pod adresem https://blog.wyremski.pl/instrukcja-instalacji-i-konfiguracji-skryptow/#platnosci

Logowanie przez Facebook i Google

Aby umożliwić użytkownikom logowanie za pomocą swojego konta Facebook lub Google, należy utworzyć odpowiednie aplikacje na swoich kontach Facebook i Google.

Link do instrukcji dotyczącej logowania przez Facebook: https://blog.wyremski.pl/instrukcja-instalacji-i-konfiguracji-skryptow/#logowanie_fb

Jako adres URI do przekierowania, proszę wpisać: https://nazwa-domeny/logowanie/fb

Link do instrukcji dotyczącej logowania przez Google: https://blog.wyremski.pl/instrukcja-instalacji-i-konfiguracji-skryptow/#logowanie_google

Jako adres URI do przekierowania, proszę wpisać: https://nazwa-domeny/logowanie/google

Zdjęcia

Skrypt wykorzystuje bibliotekę LiipImagineBundle do generowania miniatur zdjęć. Pierwsze wyświetlenie miniaturki może chwilę potrwać, zależnie od szybkości serwera. Plik konfiguracyjny znajduje się w lokalizacji /config/packages/liip_imagine.yaml.

W pliku konfiguracyjnym można dostosować wymiary miniaturek zdjęć w ogłoszeniach. Dodatkowo istnieje możliwość dodania znaku wodnego do tych zdjęć, zgodnie z https://symfony.com/bundles/LiipImagineBundle/current/filters/general.html#filter-watermark

Aby oczyścić cache zdjęć na serwerze, wykonaj następujące polecenie:

php bin/console liip:imagine:cache:remove

W ten sposób biblioteka wygeneruje nowe miniaturki.

Skrypt wymaga aktualnej wersji biblioteki GD Library, która obsługuje format WEBP.

Więcej informacji dostępnych jest pod adresem https://symfony.com/bundles/LiipImagineBundle/current/index.html

Aplikacja PWA

Skrypt jest wstępnie skonfigurowany, aby działać jako aplikacja PWA (Progressive Web App). Po zainstalowaniu skryptu możesz dostosować tytuł, kolor i inne dane aplikacji w pliku public/manifest.json.

Należy również zamienić ikonki w folderze public/uploads/icons na odpowiednie ikony w różnych rozmiarach. Możesz skorzystać z narzędzi online do generowania ikonek, takich jak https://tools.crawlink.com/tools/pwa-icon-generator/

Po zamianie ikonek, konieczne będzie wyczyszczenie pamięci podręcznej na telefonie lub komputerze.

W pliku public/offline.html możesz edytować tekst wyświetlany, gdy brakuje połączenia z Internetem.

Modyfikacje strony

Choć do obsługi strony wystarczy sama dobra znajomość obsługi Internetu, aby dokonywać indywidualnych zmian w plikach, warto posiadać wiedzę z zakresu PHP, a najlepiej znać framework Symfony. Poniżej zamieszczam listę niektórych z często używanych poleceń.

Usuwanie cache’u produkcyjnego (po np. zmianach w szablonie)

php bin/console cache:clear --no-warmup -e prod

Tworzenie nowego kontrollera

php bin/console make:controller BrandNewController

Tworzenie nowej encji i aktualizacja bazy danych

php bin/console make:entity
php bin/console make:migration
php bin/console doctrine:migrations:migrate

Aktualizacja skryptu

Autor skryptu, na prośbę klienta, może dostarczyć najnowszą wersję skryptu, ale to klient jest odpowiedzialny za przeprowadzenie aktualizacji.

Uwaga! Przed aktualizacją skryptu wykonaj kopię zapasową plików i bazy danych. Aktualizacja nadpisze wszystkie indywidualnie wprowadzone modyfikacje. Aktualizację przeprowadzaj na własne ryzyko.

Aby zaktualizować skrypt, należy postępować zgodnie z poniższymi krokami:

1. Usuń z serwera następujące katalogi:
   /bin/
   /config/
   /migrations/
   /publis/assets/
   /src/
   /templates/
   /translations/
2. Następnie wgraj na serwer wszystkie pliki i katalogi z nowszej wersji skryptu.
3. Zainstaluj od nowa biblioteki (jeśli w nowej wersji dodano nowe pakiety) za pomocą polecenia:
   composer install
4. Wykonaj aktualizację bazy danych (jeśli to konieczne) za pomocą polecenia:
   php bin/console doctrine:migrations:migrate
5. Na koniec usuń cache:
   php bin/console cache:clear --no-warmup -e prod

Historia zmian (changelog)

Znane problemy i ich rozwiązania

Aby włączyć wyświetlanie błędów na ekranie należy w pliku .env zmienić APP_ENV=prod
na

APP_ENV=dev

W wersji produkcyjnej należy wrócić do „prod”. Logi błędów można także podejrzeć w pliku /var/log/dev.log oraz /var/log/prod.log

Przy instalacji pakietów wyświetla „requires ext-zip * -> it is missing from your system. Install or enable PHP’s zip extension.”

Należy z konsoli zainstalować:

sudo apt-get install php8.1-zip

(gdzie 8.1 to wersja PHP)
Jeśli wyświetla bład z „ext-xml” należy uruchomić:

sudo apt-get install php-xml

Przy próbie wysłania maila (np. przy aktywacji ogłoszenia, rejestracji) wyświetla błąd.

Domyślnie w pliku .env jest ustawiona wysyłka maili z localhost:

MAILER_DSN=sendmail://localhost

Jeśli Twój serwer tego nie wspiera musisz ustawić wysyłkę przez np. SMTP:

MAILER_DSN=smtp://user:pass@smtp.example.com:port

Więcej informacji pod https://symfony.com/doc/current/mailer.html

Przy próbie migracji bazy danych wyświetla „An exception occured in driver: could not find driver with mysql”

Należy zainstalować sterownik mysql:

sudo apt install php-mysql

Symfony Make:Migration: The metadata storage is not up to date, please run the sync-metadata-storage command to fix this issue

W pliku konfiguracyjnym /config/packages/doctrine.yaml podana została nieprawidłowa wersja serwera bazy danych.

Wskazanie katalogu public dla domeny (np. Hostinger, Zenbox)

Niektóre hostingi nie umożliwiają wskazania katalogu dla domeny. Należy do nich np. Hostinger i Zenbox. Aby w tej sytuacji ustawić domenę żeby wskazywała na katalog public należy w katalogu public_html stworzyć plik .htaccess z takim kodem (podmieniając nazwę domeny na własną):

RewriteEngine on
RewriteCond %{HTTP_HOST} ^domain.com$ [NC,OR]
RewriteCond %{HTTP_HOST} ^www.domain.com$
RewriteCond %{REQUEST_URI} !public/
RewriteRule (.*) /public/$1 [L]

Problem z polskimi znakami w bazie danych

Problem pojawił się po imporcie gotowej bazy danych z jednego hostingu na hosting home.pl. Stare dane pobierane z bazy danych nie wyświetlały poprawnie polskich znaków. Rozwiązaniem okazało się dodanie do pliku config/packages/doctrine.yaml
doctrine:
dbal:
options:
1002: „SET NAMES 'UTF8′ COLLATE 'utf8_unicode_ci'”

Nie tworzą się zdjęcia, nie zostały załadowane style bibliotek np. edytora wizualnego

Skrypt musi mieć prawa dostępu do zapisu w folderze public. Zarówno composer przy instalacji pakietów jak i później Symfony przy uruchomionej stronie. Należy ustawić prawa dostępu 0777 dla folderu public.

Strona nie działa, wyświetla błąd: require(): open_basedir restriction in effect.

Błąd może się pojawić na hostingach AttHost po zaznaczeniu „Odizoluj stronę” w ustawieniach strony www. Należy ją odznaczyć.