Instalacja silnika forum Flarum i rozszerzeń na VPS

flarum
Tagi: #<Tag:0x00007f343bf3aae0>

#1

W tym poradniku pokażę, jak zainstalować silnik Flarum na VPS.

Przed instalacją

Musimy się upewnić, że w miejscu, gdzie ma znajdować się nasze forum nie ma żadnych plików. W przeciwnym razie instalacja nie będzie możliwa.
Potrzebujemy też serwer WWW - w moim przypadku jest to Apache, oraz serwer bazy danych - w moim przypadku jest to MariaDB.
Flarum wspiera PHP od wersji 5.6 do 7.1.
Poradnik dotyczy serwera VPS - instalacja jest możliwa zarówno na serwerach OpenVZ jak i KVM.

1. Konfiguracja serwera WWW

Zanim rozpoczniemy instalację, powinniśmy włączyć mod_rewrite.
Przechodzimy do pliku konfiguracyjnego Apache komendą
sudo nano /etc/apache2/apache2.conf
i szukamy następującej linijki:
image
Zmieniamy AllowOverride None na AllowOverride All i wykonujemy kombinację Ctrl+X oraz potwierdzamy dokonane zmiany wciskając Y a następne Enter.
Musimy jeszcze zrestartować Apache za pomocą polecenia
service apache2 restart
To już wszystko - zapraszam do kolejnego punktu :slight_smile:

2. Instalacja zip

zip oraz unzip. Nie jest to wymagany krok, ale zalecany :stuck_out_tongue:
sudo apt install zip unzip
i czekamy, aż instalacja się zakończy. Powinno wyglądać to mniej więcej tak:
image
Instalację pakietów zip i unzip mamy za sobą! :slight_smile:

3. Instalacja composera

Composer to system zarządzania pakietami dla języka PHP, dostępny jako aplikacja wiersza poleceń, która dostarcza i standaryzuje format zarządzania zależnościami skryptami i bibliotekami. Źródło: Wikipedia
Bez composera nie będziemy mogli zainstalować Flarum. Przejdźmy więc do instalacji.
Najprostszym sposobem na zainstalowanie tego systemu jest po prostu wykonanie następującej komendy:
sudo apt install composer
Po wykonaniu tej komendy otrzymamy zapytanie, czy na pewno chcemy dokonać instalacji. Wpisujemy Y w przypadku wersji angielskiej lub T w przypadku wersji polskiej i zatwierdzamy Enterem. Tak to wygląda u mnie:
image
Gdy wykonaliśmy już tę czynność, czekamy aż instalacja dobiegnie końca:
image
Przechodzimy więc do następnego kroku!

4. Utworzenie bazy danych

W tym kroku tworzymy bazę danych dla naszego forum. W tym celu przechodzimy do phpmyadmin i klikamy przycisk Nowa który znajduje się po lewej stronie:
image
Pojawi nam się następujące okienko:
image
W Nazwa bazy danych wpisujemy nazwę bazy danych (wow!), na przykład Flarum. Następnie klikamy w Utwórz. Można już wyjść z PMA.

5. Instalacja Flarum

Sam proces instalacji silnika jest prosty, jednak trwa trochę czasu (nawet kilka minut).
Pierw przechodzimy do katalogu, w którym ma się znajdować nasze forum za pomocą komendy
cd /katalog/w/którym/ma/znajdować/się/flarum
W moim przypadku jest to /var/www/html/flarum więc wykonuję komendę:
cd /var/www/html/flarum
Następnie rozpoczynamy instalację Flarum za pomocą polecenia
composer create-project flarum/flarum . --stability=beta
I czekamy aż wszystko dojdzie do tego momentu:
image
Gotowe!
Teraz musimy nadać odpowiednie uprawnienia na katalog, w którym znajduje się Flarum. W tym celu wykonujemy tą komendę:
chmod -R 777 /katalog/w/którym/znajduje/się/flarum
W moim przypadku:
chmod -R 777 /var/www/html/flarum

Teraz przechodzimy na stronę, gdzie znajduje się Flarum - ja instalowałem Flarum w katalogu flarum więc udaję się na adres moja-domena.pl/flarum.
Ukazuje nam się instalator silnika:


Wytłumaczę, co powinniśmy wpisać w dane rubryki.

Forum title: Nazwa, tytuł naszego forum. W moim przypadku będzie to Moje forum.
MySQL Host: Adres do serwera MySQL. Jeżeli Twój serwer MySQL znajduje się na tym samym VPS, co Flarum - zostaw localhost.
MySQL Database: Nazwa bazy danych dla Flarum którą ustawiliśmy w punkcie 4. W moim przypadku jest to Flarum.
MySQL Username: Użytkownik serwera MySQL. W moim przypadku jest to root.
MySQL Password: Hasło użytkownika serwera MySQL.
Table prefix: Przedrostek tabeli, w moim przypadku jest to flarum_.

Admin Username: Nazwa użytkownika dla administratora. W moim przypadku jest to DoreK.
Admin Email: Adres e-mail administratora.
Admin Password: Hasło administratora.
Confirm Password: Powtarzamy hasło wpisane wcześniej.

Po wypełnieniu danych klikamy w przycisk Install Flarum:
image
Czekamy chwilkę i naszym oczom ukazuje się świeżo zainstalowane forum!

6. Lista i instalacja rozszerzeń

Jak widać, nasze forum jest w języku angielskim. Jednak w łatwy sposób możemy to zmienić, instalując rozszerzenie.
Uwaga! Rozszerzenia są tworzone głównie przez społeczność.
Lista rozszerzeń na oficjalnej stronie Flarum: https://discuss.flarum.org/t/extensions
Lista języków na oficjalnej stronie Flarum: https://discuss.flarum.org/t/languages
Lista motywów na oficjalnej stronie Flarum: https://discuss.flarum.org/t/themes
Lista styli na oficjalnej stronie Flarum: https://discuss.flarum.org/t/styles

Po wybraniu danego rozszerzenia powinna pokazać nam się instrukcja instalacji jak i aktualizacji.
Ja wybrałem rozszerzenie dodające język polski.
Jak widać, są tu potrzebne instrukcje:


Pamiętaj, że PRZED instalacją rozszerzenia musisz znajdować się w miejscu, gdzie znajduje się Flarum. Aby dostać się do tego miejsca, wykonujemy komendę
cd /katalog/w/którym/znajduje/się/flarum
W moim przypadku jest to (jak wcześnie wspominałem) katalog /var/www/html/flarum, więc wykonuję komendę
cd /var/www/html/flarum.

Okej, czas zainstalować rozszerzenie. Wykonuję komendę podaną w instrukcji, czyli:
composer require veriael/flarum-polish
Instalacja pakietu dobiegła końca:
image

Teraz musimy włączyć rozszerzenie. W tym celu udajemy się na nasze nowo zainstalowane forum i klikamy w swoją nazwę użytkownika, po czym wybieramy Administration:
image
Jesteśmy w panelu administracji. Klikamy w przycisk Extensions:


Jak widać, domyślnie mamy zainstalowanych kilka dodatków, jednakże ten poradnik dotyczy instalacji silnika i dodatków, więc nie będę wyjaśniał, co dodaje każde z nich.
Aby aktywować zainstalowane przed chwilą rozszerzenie, klikamy na pole które jest przy jego nazwie:
image
Rozszerzenie jest już włączone, teraz wystarczy wejść w zakładkę Basics:
image
i w Default language ustawić język polski:
image
Zapisujemy zmiany za pomocą przycisku Save changes:
image
Gotowe! Wystarczy wrócić na forum za pomocą tego przycisku:
image

Zakończenie

Mam nadzieję że poradnik pomógł Ci w instalacji silnika Flarum i rozszerzeń do niego. Prosiłbym o zostawienie serduszka :slight_smile:
PS: Być może wkrótce pojawi się kolejny poradnik dotyczący tego silnika, ale nie obiecuję :stuck_out_tongue:
PS2: Jeżeli masz jakieś uwagi dotyczące poradnika - nie krępuj się i pisz śmiało w komentarzu :smiley:


Problem z itemshopem vMCShop
#2

Do działu o tworzeniu bazy danych dodałbym jeszcze informacje jak założyć bazę przez terminal, a także dopisałbym tworzenie nowego użytkownika razem z bazą dla niego, bo używanie użytkowników zbiorczych to duży błąd bezpieczeństwa :slight_smile:


#3

Myślę że to raczej temat na inny poradnik :stuck_out_tongue:


#4

Poradnik poradnikiem, ale warto zadbać o podstawowe aspekty ochrony aplikacji, w takim przypadku większość osób mniej doświadczonych zrobi sobie te bazy na koncie root, zostawiając ładną furtkę na przejęcie całej bazy danych, zamiast tylko bazy forum w wypadku utraty kontroli nad aplikacją :thinking:


#5

Fajnie, ale poradnik forsuje apache2 jako serwer HTTP. A co jeżeli ktoś woli nginxa? Warto to uwzględnić :wink:


#6

Nie korzystałem z nginxa nigdy ale wkrótce postaram się to uwzględnić :slight_smile:


#7

Ja korzystałem z innego poradnika. Jest bardziej rozbudowany.


#8

W twoim poradniku jest rozpisane jak zainstalować Apache, MariaDB oraz PHP, a dopiero następnie instalacja Flarum wraz z instalacją certyfikatu SSL. Tutaj natomiast opisana została sama konfiguracja Apache oraz instalacja silnika.
Nic dziwnego, że jest bardziej rozbudowany, skoro tłumaczy instalacje od czystego systemu.


#9

Dodam że ten poradnik jest w języku angielskim. Dla niektórych może być to problem czy coś.


#10

https://translate.google.com/translate?sl=en&tl=pl&js=y&prev=_t&hl=pl&ie=UTF-8&u=https%3A%2F%2Fwebsiteforstudents.com%2Finstall-flarum-on-ubuntu-16-04-17-10-18-04-with-apache2-mariadb-php-7-1-and-lets-encrypt-ssl-tls-certificates%2F&edit-text=
:wink:


#11

niektórzy nie tolerują tłumacza google który może coś… poprzekręcać :kappa:
poza tym trochę odchodzimy od wątku


#12

Szczególnie, że przetłumaczyło części niektórych komend.
Istotne, aby były tak jak w Angielskim.


#13

Hej. Jak uruchamiam panel administratora mam błąd 404


#14

Wykonaj punkt 1. Nie masz włączonego mod_rewrite


#15

Włączałem


#16

Dobra jednak nie włączyłem


#17

A jak wyłączyć weryfikacje konta przez email? Bo nie mogę go skonfigurować


#18

Pojawia mi się coś takiego po kliknięciu przycisku Install Forum:

Something went wrong: SQLSTATE[42000]: Syntax error or access violation: 1067 Invalid default value for ‘notifications_read_time’ (SQL: ALTER TABLE mtf_users CHANGE notification_read_time notifications_read_time DATETIME DEFAULT ‘NULL’)


#19

Poradnik przydatny, dzięki za stworzenie go :slight_smile:

Warto wspomnieć, że Flarum można wykorzystać nie tylko jako forum, ale również po lekkiej konfiguracji jako bloga.
Podana przez Ciebie wersja tłumaczenia nie jest już wspierana przez Flarum, występuje błąd przy włączeniu.
Ogólnie bardzo dużo rozszerzeń przestało działać po aktualizacji silnika przez twórców. :frowning:


Tutaj jest nowa wersja tłumaczenia stworzona przez mnie: