To jest tylko wersja do druku, aby zobaczyć pełną wersję tematu, kliknij TUTAJ
phpBB2 by Przemo
Support forów phpBB2 modified by Przemo

Modyfikacje gotowe - Jak instalować MODyfikacje ?

Crack - 28-03-2005, 11:40
Temat postu: Jak instalować MODyfikacje ?
Opis pochodzi z FAQ serwisu phpBBhelp.pl. Jest to wersja z poprawionymi literówkami, błędami gramatycznymi ;) i uaktualniona o zmiany wprowadzone 23 lipca 2005 przez MOD Team z phpBB.com.
<hr />
Prawie Każda modyfikacja (często nazywana po prostu hackiem) wymaga zmian w plikach naszego forum.
Do hacków załączone są także nowe pliki, które należy przegrać we wskazane miejsce naszego forum.

Pamiętaj - najpierw zrób kopię plików, które będziesz edytować oraz kopię bazy danych!

Hack zawiera szczegółową instrukcję instalacji - najczęściej jest plik install.txt lub inny z rozszerzeniem .txt albo .mod np nazwa_hacka.txt

Każdy taki plik zawiera nagłówek:
Kod:
##############################################################
## MOD Title:        Nazwa moda
## MOD Author:       Autor < email@autora > (Imię i nazwisko) strona_domowa
## MOD Description:  Krótki opis hacka - do czego on właściwie służy :)
## MOD Version:      x.y.z
##               
## Installation Level:  Poziom trudności instalacji (Easy/Intermediate/Advanced)
## Installation Time:   czas instalacji
## Files To Edit:       ilość i nazwy plików które trzeba edytować
## Included Files:      załączone pliki
## License:             odnośnik do tekstu i nazwa licencji na jakiej jest
##                      wypuszczony mod, najczęściej GPL 2
##############################################################
## Author Notes:
## Tu znajdują się jeszcze dodatkowe informacje. Np. przypomnienie żeby zrobić kopie
## plików które trzeba edytować i inne dodatkowe informacje, np. zależność moda od
## konkretnej wersji PHP lub serwera bazodanowego.
##############################################################
## MOD History:
##
##   RRRR-MM-DD - Version x.x.x
##      - informacje dotyczące danej wersji
##
##############################################################



Poniżej nagłówka zaczyna się opis instalacji. Ma on prostą budowę i wygląda mniej więcej tak:

Kod:
#
#-----[ POLECENIE 1]------------------------------------------
#
KOD 1

#
#-----[ POLECENIE 2]------------------------------------------
#
KOD 2

itd.



Polecenie 1 odnosi się do kodu 1 itd.

Możliwe polecenia to:

1. <a href="#action_sql" class="postlink">SQL</a> - wykonaj zapytanie do bazy, np. przy pomocy phpMyAdmina
2. <a href="#action_copy" class="postlink">COPY</a> - skopiuj pliki
3. <a href="#action_diy" class="postlink">DIY INSTRUCTIONS</a> - opis akcji do ręcznego wykonania, Do It Yourself - Zrób To Sam(a)
4. <a href="#action_open" class="postlink">OPEN</a> (nazwa pliku) - otwórz (plik)
5. <a href="#action_find" class="postlink">FIND</a> - znajdź
6. <a href="#action_replace" class="postlink">REPLACE WITH</a> - zamień na
7. <a href="#action_aadd" class="postlink">AFTER, ADD</a> - dodaj po
8. <a href="#action_badd" class="postlink">BEFORE, ADD</a> - dodaj przed
9. <a href="#action_increment" class="postlink">INCREMENT</a>, <a href="#action_increment" class="postlink">IN-LINE INCREMENT</a> - zwiększ/zmniejsz liczbę
10. <a href="#action_ifind" class="postlink">IN-LINE FIND</a> - w linii znajdź
11. <a href="#action_iaadd" class="postlink">IN-LINE AFTER, ADD</a> - w linii dodaj po
12. <a href="#action_ibadd" class="postlink">IN-LINE BEFORE, ADD</a> - w linii dodaj przed
13. <a href="#action_ireplace" class="postlink">IN-LINE REPLACE WITH</a> - w linii zamień na
14. <a href="#action_eom" class="postlink">SAVE/CLOSE ALL FILES</a> - koniec opisu, zapisz zmiany i zamknij wszystkie pliki

<a id="action_sql"><h3>1. SQL</h3></a>
Kod:
#
#-----[ SQL ]------------------------------------------
#
CREATE TABLE `phpbb_config` (
  `config_name` varchar(255) NOT NULL default '',
  `config_value` varchar(255) NOT NULL default '',
  PRIMARY KEY  (`config_name`)
) TYPE=MyISAM;



W phpMyAdminie klikamy zakładkę SQL, lub, jeśli jest to Lycos, to pod nazwami tabel jest pole tekstowe.
Kod znajdujący się pod poleceniem SQL należy skopiować w to pole i kliknąć "Wykonaj".
W tym przypadku jest to utworzenie tabeli phpbb_config
Jeśli nie wiesz co to phpMyadmin, albo nie ma go na serwerze, możesz wygenerować plik który po wgraniu na serwer i odpaleniu w przeglądarce dokona odpowiednich zmian w bazie

Plik wygenerować można TUTAJ.

<a id="action_copy"><h3>2. COPY</h3></a>
Kod:
#
#-----[ COPY ]------------------------------------------
#
copy plik to katalog_docelowy/plik
np.
copy foo_body.tpl to templates/subSilver/foo_body.tpl


Tu chyba jest wszytko jasne.

<a id="action_diy"><h3>3. DIY INSTRUCTIONS</h3></a>
Kod:
#
#-----[ DIY INSTRUCTIONS ]------------------------------------------
#
treść instrukcji
np.
ustaw plikowi moj_mod.php chmod na 666


Tu chyba wszystko jasne, akcja ta może być wykorzystana w dowolny sposób przez autora modyfikacji do poinformowania o dodatkowych operacjach które są wymagane.

<a id="action_open"><h3>4. OPEN</h3></a>
Kod:
#
#-----[ OPEN ]------------------------------------------
#
katalog/nazwa_pliku
np.
includes/constants.php


Otwórz plik o wskazanej nazwie np. przy pomocy Edit Plusa.

<a id="action_finc"><h3>5. FIND</h3></a>
Kod:
#
#-----[ FIND ]------------------------------------------
#
Kod 1

np.
{L_NEW_POSTS}



Znajdź w otwartym pliku Kod 1.

Po poleceniu FIND mogą znaleźć się następujące polecenia:

<a id="action_replace"><h3>6. REPLACE WITH</h3></a>
Kod:
#
#-----[ REPLACE WITH ]------------------------------------------
#
Kod 2

np.

{L_YOUR_VARIABLE}


Czyli zamienić znaleziony wcześniej Kod 1 na Kod 2.
W tym przypadku zamienić {L_NEW_POSTS} na {L_YOUR_VARIABLE}.

<a id="action_aadd"><h3>7. AFTER, ADD</h3></a>
Kod:
#
#-----[ AFTER, ADD ]------------------------------------------
#
Kod 3

np.
{L_NOWA}


Czyli dodaj PO tym co znalazłeś(aś), czyli po Kod 1, to, co znajduje się pod poleceniem AFTER, ADD (czyli Kod 3).
W tym przypadku po {L_NEW_POSTS} dodaj {L_NOWA}.

<a id="action_badd"><h3>8. BEFORE, ADD</h3></a>
Kod:
#
#-----[ BEFORE, ADD ]------------------------------------------
#
Kod 4

np.
{L_INFO}


Czyli dodaj PRZED tym co znalazłeś(aś), czyli przed Kod 1, to, co znajduje się pod poleceniem BEFROE, ADD (czyli Kod 4).
W tym przypadku przed {L_NEW_POSTS} dodaj {L_INFO}.

<a id="action_increment"><h3>9. INCREMENT, IN-LINE INCREMENT</h3></a>
Kod:
#
#-----[ FIND ]------------------------------------------
#
Powered by <a href="http://www.phpbb.com/" target="_phpb" class="copyright">phpBB</a> &#169; 2001, {%:1} phpBB Group<br />{TRANSLATION_INFO}</span></div>
#
#-----[ INCREMENT ]-------------------------------------
#
%:1 +10


Ta akcja służy do zwiększania i zmniejszania liczb, najczęściej jest wykorzystywana w szablonach do modyfikacji wartości atrybutów colspan i rowspan. INCREMENT występuje zawsze po FIND albo IN-LINE FIND w których liczba do zmienienia została zastąpiona przez {%:1}. Jeśli liczb jest więcej, kolejne są zastąpione przez {%:2}, {%:3} itd.

W tym przypadku do liczby zastąpionej przez {%:1} należy dodać 10.

Czasem zamiast INCREMENT można się spotkać z akcją IN-LINE INCREMENT. Obydwie działają tak samo.

<a id="action_ifind"><h3>10. IN-LINE FIND</h3></a>
Kod:
#
#-----[ IN-LINE FIND ]------------------------------------------
#
Kod 5

np.
{L_COS_TAM}


Jeśli po FIND występuje takie polecenie, to w poleceniu FIND (<a href="#action_find">pkt. 5</a>) odszukać należało jakąś linię. W tej właśnie linii (Kod 1) odszukać trzeba Kod 5.

Po akcji IN-LINE FIND występuje IN-LINE INCREMENT albo jedno z trzech poniższych poleceń:

<a id="action_iaadd"><h3>11. IN-LINE AFTER, ADD</h3></a>
Kod:
#
#-----[ IN-LINE AFTER, ADD ]------------------------------------------
#
Kod 6

np.
{NAPIS}


Czyli PO Kod 5 w tej linii należy dodać Kod 6, w tym przypadku po {L_COS_TAM} wstaw {NAPIS}.

<a id="action_ibadd"><h3>12. IN-LINE BEFORE, ADD</h3></a>
Kod:
#
#-----[ IN-LINE BEFORE, ADD ]------------------------------------------
#
Kod 7

np.
{NAPIS2}


Czyli PRZED Kod 5 wstaw Kod 7. w tym przypadku PRZED {L_COS_TAM} wstaw {NAPIS2}.

<a id="action_ireplace"><h3>13. IN-LINE REPLACE WITH</h3></a>
Kod:
#
#-----[ IN-LINE REPLACE WITH ]------------------------------------------
#
Kod 8

np.
{NAPIS3}


Czyli kod 5 należy zastępić Kod 8. tutaj {L_COS_TAM} należy zamienić na {NAPIS3}.

<a id="action_eom"><h3>14. SAVE/CLOSE ALL FILES</h3></a>
Kod:
#
#-----[ SAVE/CLOSE ALL FILES ]----------------------------------
#
# EoM


Zamknij otwarty plik, oczywiście zapisując wprowadzone zmiany.

Mam nadzieję, że pomoże wam to w instalacji modyfikacji w swoim forum.
Naprawdę nie jest to trudne.
Zawsze jeśli cos nie chodzi po przeprowadzonych zmianach możecie wrócić do przeprzdniej wersji zamieniając pliki na oryginalne, których kopie bezpieczeństwa wykonaliście przez przystąpieniem do instalacji.

shqvarny - 11-05-2005, 10:51

instrukcja jest kompletna, nie powinno być żadnych pytań, więc zamykam, bo już się pojawiły posty-śmiecie w tym topicu.
nice work Crack :D as usually :twisted:

Crack - 01-08-2005, 14:35

Poprawiłem kilka błedów które jeszcze zostały i uaktualniłem opis o akcje DIY INSTRUCTIONS i INCREMENT.
Crack - 20-11-2006, 16:22

Uaktualniony link do generatora zapytań SQL: http://www.phpbbhacks.com/forums/db_generator.php

Stare:
http://www.phpbb2.pl/forum/db_generator.php (nowy adres zgłosił hudys).

Edit:
Znowu zmiana, http://www.phpbbhelp.pl/forum/db_generator.php



Powered by phpBB modified by Przemo © 2003 phpBB Group