--=REKLAMA=--

Jak stworzyć moduł

Z Joomla!WikiPL

Wersja Zwiastun (dyskusja | edycje) z dnia 19:52, 7 gru 2013

(różn.) ← poprzednia wersja | przejdź do aktualnej wersji (różn.) | następna wersja → (różn.)

Jak stworzyć prosty moduł Joomla!

Moduły to małe aplikacje, które w prosty sposób możemy instalować w systemie. Zwykle nie zawierają więcej niż kilka plików.

Domyślnie wraz z systemem dostępne mamy kilka modułów. Przykładowymi są np. mod_latest, mod_banners i mod_stats.

W tym poradniku stworzymy prosty moduł wyświetlający powitanie, które zostanie pobrane z parametrów modułu.

Struktura plików modułu

Kilka plików, które nasz moduł Joomla! powinien zawierać:

  • mod_hello.php - plik główny modułu. To on zostanie wywołany gdy wstawimy moduł w dowolnym miejscu na stronie.
  • mod_hello.xml - tutaj zawarte są informacje instalacyjne modułu oraz definicje parametrów
  • helper.php - plik pomocniczy to w nim powinny być pobierane i przygotowywane dane dla modułu (także te przesyłane z bazy danych)
  • tmpl - katalog, który zawiera pliku szablonów modułów
  • tmpl/default.php - domyślny widok modułu

Tworzenie pliku mod_hello.xml

Plik ten zawiera dane niezbędne do instalacji naszego modułu. W nim nazwiemy nasz moduł, spiszemy listę plików modułu i pliki języków. To w tym pliku deklarowane są parametry naszego modułu.

<?xml version="1.0" encoding="utf-8"?>
<install type="module" version="1.5.0">
    <name>Hello - Powitanie</name>
    <author>Jan Kowalski</author>
    <version>0.9.0 beta</version>
    <description>Prosty moduł Joomla!.</description>
    <files>
        <filename module="mod_hello">mod_hello.php</filename>
        <filename>index.html</filename>
        <filename>helper.php</filename>
        <folder>tmpl</folder>
    </files>
    <params>
        <param name="powitanie" default="witam" type="text" label="Tekst powitania" description="Tekst naszego powitania" />
    </params>
</install>

Dziękujemy za wkład

» Stefan Wajda [zwiastun],