Nawigacja
Pierwsza wtyczka do PHP-Fusion v7 cz.2: Instalacja
Napisane przez Chemikpil dnia 06 marca 2011 19:05 · 0 komentarzy · 9409 czytań · · ·
Streszczenie:
Dziś druga część kursu, o tym jak napisać swoją pierwszą wtyczkę do PHP-Fusion v7. Naszym głównym celem będzie stworzenie pliku instalacyjnego. Wszystko to będzie podstawą przykładowego skryptu, wypisującego losowe cytaty.Plik instalacyjny
Pierwszym plikiem jaki przyjdzie nam stworzyć, jest infusion.php. Z poprzedniej części wiemy już, że odpowiada on za zainstalowanie naszej wtyczki. Rozróżniane są dwa typy instalatorów: te które tworzę w bazie tabele, oraz te które tego nie robią. W tym artykule zajmiemy się drugim typem, a pierwszym zajmiemy się w innej części. Zaczynamy.
Na początku zabezpieczamy nasz plik przed odwołaniem się do niego poprzez adres URL.
if (!defined("IN_FUSION")) { die("Access Denied"); }
Następnie dołączamy pliki językowe (dokładniej o lokalach powiem w dalszej części):
if (file_exists(INFUSIONS."cite_panel/locale/".$settings['locale'].".php")) {
include INFUSIONS."cite_panel/locale/".$settings['locale'].".php";
}
Jako cite_panel, podajemy nazwę katalogu swojej wtyczki. Teraz zajmiemy się głównymi informacjami na temat infusiona. W kodzie pozostawiłem komentarze by wszystko było jasne:
$inf_title = "Cite panel"; // Nazwa infusiona
$inf_description = "$locale['HL102']"; // Opis infusiona
$inf_version = "1.0"; // Wersja infusiona
$inf_developer = "Autor"; // Autor infusiona
$inf_email = "adres@email.com"; // Email autora
$inf_weburl = "www.twojastrona.pl"; // Strona domowa autora
$inf_folder = "hello_panel"; // Folder w którym znajdują się pliki infusiona
$inf_newtables = 0; // Ilość tworzonych tabel
$inf_insertdbrows = 0; // Ilość wstawianych wierszy
$inf_altertables = 0; // Ilość zmienianych tabel
$inf_deldbrows = 0; // Ilość usuwanych tabel
Myślę, że wszystko jest zrozumiałe. Wspomnę tu tylko o tym na jakiej zasadzie odbywa się aktualizacja. Wszystko opiera się o wersję skryptu, którą jeżeli zmienisz na wyższą niż ta zainstalowana, PHP-Fusion udostępni tobie możliwość zaktualizowania wtyczki.
Na samym końcu definiujemy link, który automatycznie doda się do nawigacji głównej strony.
$inf_sitelink[1] = array(
"title" => $locale['HL103'], // Tytuł linku
"url" => "hello_index.php", // Adres pliku
"visibility" => "0" //Widoczność 0 - wszyscy, 1 - zalogowani, 2 - admin
);
To by była na tyle, jeżeli chodzi o plik instalacyjny. Poniżej cały plik:
<?php
if (!defined("IN_FUSION")) { die("Access Denied"); }
if (file_exists(INFUSIONS."cite_panel/locale/".$settings['locale'].".php")) {
include INFUSIONS."cite_panel/locale/".$settings['locale'].".php";
}
$inf_title = "Cite panel"; // Nazwa infusiona
$inf_description = "$locale['HL102']"; // Opis infusiona
$inf_version = "1.0"; // Wersja infusiona
$inf_developer = "Autor"; // Autor infusiona
$inf_email = "adres@email.com"; // Email autora
$inf_weburl = "www.twojastrona.pl"; // Strona domowa autora
$inf_folder = "hello_panel"; // Folder w którym znajdują się pliki infusiona
$inf_newtables = 0; // Ilość tworzonych tabel
$inf_insertdbrows = 0; // Ilość wstawianych wierszy
$inf_altertables = 0; // Ilość zmienianych tabel
$inf_deldbrows = 0; // Ilość usuwanych tabel
$inf_sitelink[1] = array(
"title" => $locale['HL103'], // Tytuł linku
"url" => "cite_index.php", // Adres pliku
"visibility" => "0" //Widoczność 0 - wszyscy, 1 - zalogowani, 2 - admin
);
?>
Locale
Locale, czyli pliki językowe pomagają nam, lub innym osobom przetłumaczyć wtyczkę, dzięki trzymaniu wszystkich tekstów występujących w naszej wtyczce, w jednym miejscu. Nasz plik, który umieszczamy w katalogu Locale, powinien zostać nazwany Polish.php oraz Polish-UTF8.php. Jego zawartość prezentuje poniżej:
<?php
$locale['CP102'] = "Panel wyświetlający losowe cytaty";
$locale['CP103'] = "Losowe cytaty";
?>
Składnia jest dość prosta: do zmiennej tablicowej przypisywany jest ciąg znaków, który ma zostać wyświetlony przez skrypt. Indeks tej zmiennej musi być unikalny, i przyjęło się że pierwsze dwie litery to skrót naszej wtyczki a cyfry to po prostu kolejne numery. W ten sposób mamy pewność, że nasze locale będą zawsze unikalne. Aby taki tekst wyświetlić, należy w kodzie użyć jednej ze zmiennych, której aktualnie potrzebujemy, czyli np:
echo "Nazwa wtyczki: $locale['CP102']";
Podsumowanie
Dziś nauczyliśmy się tworzyć instalator, oraz dowiedzieliśmy się jak wyglądają i do czego służą pliki językowe. W następnej części zajmiemy się wyświetlaniem efektów pracy wtyczki na stronie i w panelu bocznym. Zapraszam
Komentarze
Dodaj komentarz
Oceny
Zaloguj się lub zarejestruj, żeby móc zagłosować.
Świetne! | 100% | [1 głos] | |
Bardzo dobre | 0% | [0 głosów] | |
Dobre | 0% | [0 głosów] | |
Średnie | 0% | [0 głosów] | |
Słabe | 0% | [0 głosów] |