Domů › Vlastní moduly

Vlastní moduly

Vytvoření vlastního mini modulu

Minimální adresářová strura:

  • my_module/
    • my_module.info
    • my_module.module (seznam vhodných hooks)
    • (my_module.install – použije se pouze při prvním zapnutí modulu)

Uvědomte se rozdíly mezi pojmy:

  1. instalace modulu – aplikuje se pouze při prvním zapnutí modulu (např. vytovří tabulky v databázi)
  2. zapnutí modulu – umožňuje modul používat a upravovat jeho nastavení
  3. vypnutí modulu – zachová nastavené hodnoty
  4. odinstalace modulu – umožňuje např. odstranit tabulky v databázi

Hooks

Hooks (háčky) můžeme chápat např. jako speciálně pojmenované PHP funkce. U vyhledané funkce nahraďte slovo hook_... za název modulu např. my_module_... např.:

hook_install() => my_module_install()
hook_enable() => my_module_enable()
hook_disable() => my_module_disable()

Bloky

Pro vytvořeního vlastního modulu, který má zobrazovat nějaký blok(y) jsou třeba minimálně dva hooky:

hook_block_info() => my_module_info()
hook_block_view() => my_module_view()

Při tvorbě bloku pomocí modulu je vhodné projít si demonstrační kód viz block_example.module.

Pro jednoduché uložení a získání dat je možné využít databázovou tabulku variable a funkce variable_set() a variable_get().

Globálné proměnné např. o uživateli je možné získat zápisem:

global $user;

Textové řetězce je nutné zapisovat do funkce t().

Formátování zdrojového kódu

  • funkce se zapisují malými písmeny
  • počátení { se píše za názvem funkce, ukončující } se píše smostatn na novém řádku
  • pro odsazení se používají 2 znaky