Įvadas

Kas yra 2-o lygio modulis?

Kaip prijungti tuščią modulį?

1. Sukurkite direktoriją user(X), jeigu tokios dar nėra. (Turėkite omeny, kad X neturi viršyti Jūsų turimų laisvų modulių skaičių licencijoje)
2. Direktorijoje sukurkite failus _init.php, _admin.php, _unilang.txt. Apie failų turinį skaitykite skyrelyje "Iš ko susideda modulis".
3. Persijunkite į sistemą ir pabandykite sukurti Jūsų sukurto tipo puslapį (papildomą elementą ar pan.) sistemoje. Jeigu Jūs matote savo modulį tipų sąraše, reiškia Jums pasisekė sukurti tuščią modulį.

Iš ko susideda modulis?

Kintamieji pasiekiami administravimo srityje:

Objektai:

• $ipyr - iPyr_Core objektas
• Common - statiškai pasiekiamas bendrinių funkcijų rinkinys

Funkcijos:

• NOT_INCLUDED - parodo, kad failas nėra itraukiamas (include) į sistemą. Jo reikšmė visuomet yra lygi FALSE. Failo pradžioje įrašę eilutę: if(NOT_INCLUDED) return FALSE;
  išvengsite galimo tiesioginio failo iškvietimo iš išorės, kas padidins sistemos saugumą.
• IPYR_ADMIN_MODE - true ¦ false. Parodo, ar failas veikia administravimo rėžime ar peržiūros. Priklausomai nuo to, pavyzdziui, administravimo rėžime, Jūs galite užkrauti modulio kalbų failą. Ne administravimo rėžime to daryti nebūtina, kadangi kalbiniai tekstai nėra atvaizduojami.

_init.php

• $lang_id - administravimo rėžime nustato einamąją sąsajos kalbą. Pvz. en, lt, ru, de ir t.t.
• $_module_name - šio modulio sisteminis pavadinimas paruoštas sistemos.
• $dir - dabartinė modulio direktorija. Leidžia sutaupyti procesoriaus laiką jos paieškai.

     <?php
                  if(NOT_INCLUDED) return false;         

     if(IPYR_ADMIN_MODE and $lang_id){
                          loadLang( $dir . "/_lang/" . $lang_id . ".php" );
                  }     

     $modules[$_module_name] = array(
                     "use_templates" => array("main", "part"),
                          "name" => "MyModule",
                      "group" => "gen",
                          "cache" => 1,
                  );
                  ?>         

_admin.php

         <?php
                      // _admin.php failo pavyzdys
                      if(NOT_INCLUDED) return false;         

         // Veiksmu apdorojimas
                      switch($action){
                       case "edit": // Standartinis puslapio redagavimo veiksmas
                        // Apdorojame HTML redaktoriaus siunčiamą tekstą (būtinas
                        // kiekvienam redaktoriaus siunčiamam kintamajam)
                        $text = iPyr_Html::parseHtml($_POST["content_area"]);
                       
                        // Parametrų išsaugojimas Unidb duomenų bazėje
                        $ipyr -> unidb -> putVal($_item_id, "content", $text, "text");
                        $ipyr -> unidb -> putVal($_item_id, "intro", $_POST["intro"], "varchar255");
                        
                        // Atnaujiname $_element_values duomenų masyvą, nes ką tik buvo pakeistas.
                        $_element_values = $ipyr -> unidb -> getVal($_item_id);
                       break;
                      } 
                      ?>
                      <form method="post" action="<?php echo $_SELF . "?page=" . $page ?>" id="ipyrAdminForm">
                      <input type="hidden" name="action" value="edit" />
                      <table width="100%" border="0" cellpadding="1" cellspacing="1">
                  
                       <tr>
                        <td><?php echo txt("Title"); ?></td>
                        <td><input type=text name=intro value="<?php echo htmlspecialchars($_element_values["intro"]); ?>" class="formText"></td>
                       </tr>
                       <tr>
                        <td height="330" colspan="2"><?php iPyr_Html::printHTMLedit("content_area", $_element_values["content"], $_item_id); ?></td>
                       </tr>
                       <tr>
                        <td colspan="2" height="1">
                        <input type="submit" class="formButton" value="<?php echo txt("Save"); ?>">
                        <input type="reset" class="formButton" value="<?php echo txt("Reset"); ?>">
                        </td>
                       </tr>
                     </table>
                   </form>
                        

_print.php

     <?php
                  // _print.php failo pavyzdys
                  if(NOT_INCLUDED) return false;         

     // Perduodame visas  turinio reikšmes į Smarty
                  foreach($_element_values as $key => $val){
                    $ipyr -> template -> assign($key, $val);
                  }
                 
                  
                  // Patikriname ar toks šablonas egzistuoja ar nepamiršo 
                  // jo sukurti pajunginėtojas. Jeigu šablonas yra, apdorojame (parse) jį ir grąžiname 
                  // viską ką gavome sistemai. 
                  if($ipyr -> template -> exists( $template_path . "/main" )){
                      return $ipyr -> template -> fetch( $template_path . "/main" );
                  }else{
                      // Jeigu šablono nėra, grąžiname klaidos kodą
                      return -1028;
                  }
                  ?>     

_class.php

     // Constructor
                  function iPyr_Tree_news1 (&$parent, $name){
                     $this -> modules = array();
                     $this -> parent =& $parent;
                     $this -> _top =& $parent -> _top;
                     $this -> name = $name;
                  }         

_unilang.txt

_derived.php

_dependents.inc.php

Kaip sukurti nurodyto tipo puslapį?

Šablonų palaikymas

Kešuoti ar nekešuoti?

Kaip sukurti papildomo elemento moduli?

_init.php

"group" parametras turi turėti reikšmę "spec".

_admin.php

Papildomas elementas, kuris dar nėra išsaugotas, neturi savo item_id. Jis atsiranda tik išsaugojimo metu.

"Submit" ir "Reset" mygtukų kurti nereikia. Sistema pati sukurs mygtuką "Užbaigti".

Forma privalo turėti id="ipyrAdminForm".

Tekstinis WYSYWYG redaktorius nėra inicializuojamas pagal nutylėjimą. Todėl norėdami naudoti redaktorių, failo pradžioje įdėkite:

     include_once $_cfg["system_dir"] . "/components/html_editor/dhtml.php";         

Kaip sukurti praplėtimą (extension)?

_init.php

     $derives["prapleciamo_modulio_pavadinimas"][$_module_name] = array("name" => txt("JusuModulioPavadinimas"));         

_derives.php

Kaip sukurti sudėtinio puslapio elementą?

Sistemos objektai

Modulių karkasai (šablonai)