Első modul, rá kellene nézni

Hello

Érdemes betartani néhány dolgot a függvények és a változók elnevezésével kapcsolatban.

A függvény nevek mindig a modul nevével kezdődjenek, amit esetleg egy aláhúzás karakter előzhet meg.
function _tartalom_konvert()
helyett
function tesztmodule_tartalom_konvert()
vagy
function _tesztmodule_tartalom_konvert()

Ugyan ez vonatkozik a variable_set() által használt változókra, ami magával vonza azt, hogy a hook_settings_form() ürlapon használt nevek is megkapják a modul név előtagot.

http://api.drupal.org/api/5/function/hook_forms
_validate és _submit utótagok az ürlap kezelés esetében

- A link készítésére használj inkább l() függvényt.
- HTML kimenethez használd a Drupal sminkelhető függvényeit.:

function modulneve_valami(){
...
$output = '[geshifilter-html]kimenet[/geshifilter-html]';
return $output;
}

helyette:

function modulneve_valami(){
...
$output = theme('modulneve_html_kimenet');
return $output;
}
 
function theme_modulneve_html_kimenet{
$output = '[geshifilter-html]kimenet[/geshifilter-html]';
return $output;
}

így ha meg akarod változtatni a kimenetet, vagy valaki más aki használja a modulodat akkor elég annyit csinálnia, hogy ezt a függvényt lemásolja a template.php fájlba és a theme_ helyett beírja a smink nevét.

pp

Helló!

A 3 kérdésedre tudok válaszolni, a tesztmodul jelenleg nem jön be a megadott címen, gondolom azóta továbbfejlesztetted. :)

Először ezzel kezdem:

Ha az adminsztrációs oldalon elmentik a modul beállításait, valamilyen módon lehetséges egy függvény lefuttatása?

Igen, egy apró trükkel: tegyük fel, hogy tesztmodul_admin_beallitasok() a beállításos függvényed neve, aminek a kimenetét a system_settings_form()-mal küldöd vissza. Ekkor hozzál létre egy tesztmodul_admin_beallitasok_submit() nevű függvényt:

function tesztmodul_admin_beallitasok_submit($form_id, $form_values) {
  system_settings_form_submit($form_id, $form_values);
 
  // Ide jön amit akarsz itt futtatni
}

Így miután elmenti a Drupal a beállításokat elvégezheti a függvény a dolgát.

Ha a '#type' => 'button' segítségével gombot hozok létre az adminisztrációs felületen, milyen módon tudok ahhoz eseményt (mondjuk egy függvény végrehajtását) rendelni?

A következő módon: hozz létre több 'submit'-os gombot, pl.

  $form['bekuldes'] = array(
    '#type' => 'submit',
    '#value' => t('Beküldés'),
  );
  $form['torles'] = array(
    '#type' => 'submit',
    '#value' => t('Törlés'),
  );

A $form-ot kezelő függvénynél (előző példában ez a tesztmodul_admin_beallitasok_submit($form_id, $form_values) ) a $form_values['op'] értéknél fog megjelenni annak a gombnak az értéke, amire rákattintottál, tehát ha pl. a törlés gombra kattintottál, akkor a t('Törlés') lesz a $form_values['op'] értéke. így pl.

function tesztmodul_admin_beallitasok_submit($form_id, $form_values) {
  system_settings_form_submit($form_id, $form_values);
 
  // Ide jön amit akarsz itt futtatni
  if ($form_values['op'] == t('Törlés')) {
     // Töröljünk ezt meg azt...
  }
}

Ui.: Várható továbbfejlesztés, hogy az adminisztrációs oldalon meg lehet adni időpontokat (pl. 8 12:30 21), és a tartalmat csak a megadott időpontok után következő időzített feladatok futásakor tölti le.

Ez egyszerűbb: beállítod az időpontot az admin oldalon, a tesztmodul_cron()-nál meg egy variable_get()-tel ezt lekérdezed, majd megnézed hogy elmúlt-e már az időpont. Ha még nem, akkor nem lesz semmi visszatérési értéke a függvénynek. :)