{"id":235,"date":"2008-12-02T13:56:25","date_gmt":"2008-12-02T12:56:25","guid":{"rendered":"http:\/\/morony.pl\/?p=235"},"modified":"2008-12-02T14:00:27","modified_gmt":"2008-12-02T13:00:27","slug":"joomla-piszemy-pierwszy-modul","status":"publish","type":"post","link":"https:\/\/morony.pl\/?p=235","title":{"rendered":"Joomla – Piszemy pierwszy modu\u0142"},"content":{"rendered":"

Kiedy skrypt napotyka \u017c\u0105danie wyrenderowania jakiego\u015b modu\u0142u, wtedy za pomoc\u0105 klasy JModuleHelper pobierana jest zawarto\u015b\u0107 pliku modules\/mod_nazwamodulu\/mod_nazwamodulu.php – to tak w uproszczeniu, bo jeszcze w zale\u017cno\u015bci od templatki modu\u0142 mo\u017ce by\u0107 ubierany w jakie\u015b divy albo tabelk\u0119. A wi\u0119c do programisty teoretycznie nale\u017cy napisanie pliku mod_nazwamodulu.php. Praktycznie – te\u017c tak jest. Nale\u017cy jednak pami\u0119ta\u0107 o pewnych “trendach” jakich powinno si\u0119 trzyma\u0107 pisz\u0105c modu\u0142y. Przez kilka nast\u0119pnych artyku\u0142\u00f3w b\u0119dziemy uczy\u0107 si\u0119 w\u0142a\u015bnie tych trend\u00f3w. B\u0119dziemy te\u017c powoli przyswaja\u0107 budow\u0119 samej Joomli. Nie b\u0119dziemy natomiast uczy\u0107 si\u0119 PHP. To mam nadziej\u0119 ju\u017c w jakim\u015b stopniu jest opanowane<\/p>\n

Po pierwsze – Plan<\/h2>\n

Musimy si\u0119 najpierw zastanowi\u0107 co chcemy zrobi\u0107 i jako\u015b to rozplanowa\u0107. Nasz modu\u0142 nie b\u0119dzie zbyt skomplikowany. Jego dzia\u0142anie polega\u0107 b\u0119dzie na wypisaniu na ekran “Hello world”. Ca\u0142o\u015b\u0107 wi\u0119c zakodujemy po prostu w pliku mod_hello.php – poniewa\u017c tak b\u0119dzie nazywa\u0142 si\u0119 nasz komponent – mod_hello.<\/p>\n

mod_hello<\/h2>\n

zobaczmy na poni\u017cszy kod<\/p>\n

<?php\r\n\/**\r\n * Modu\u0142 mod_helloworld - stworzony na potrzeby www.morony.pl\r\n * autor Maciej Mucha, maciej@morony.pl\r\n *\/\r\n\r\ndefined('_JEXEC') or die('Direct Access to this\r\n\t\t location is not allowed.');\r\n\r\necho 'Hello World!';<\/span><\/pre>\n
Jest to zwyk\u0142y plik php. Wyja\u015bnienia wymaga linia sprawdzaj\u0105ca istnienie sta\u0142ej ‘_JEXEC’. Jest to sta\u0142a zdefiniowana w pliku index.php. Joomla ca\u0142a opiera si\u0119 w\u0142a\u015bnie na tym pliku. tzn wszystkie adresy naszej strony to index.php?… Nie ma wi\u0119c potrzeby otwierania bezpo\u015brednio jakiegokolwiek\u00a0innego\u00a0pliku (mo\u017ce to by\u0107 nawet niebezpieczne). Sprawdzamy wi\u0119c czy plik zosta\u0142 wczytany za pomoc\u0105 pliku index.php. Je\u015bli nie – wtedy blokujemy dost\u0119p. t\u0105 klauzul\u0119 mo\u017cemy znale\u017a\u0107 prakrycznie w ka\u017cdym pliku php wchodz\u0105cym w sk\u0142ad joomli.<\/p>\n
Kiedy jeste\u015bmy ju\u017c pewni \u017ce strona zosta\u0142a wczytana prawid\u0142owo przechodzimy do w\u0142a\u015bciwego kodu. W tym przypadku kod nie wymaga chyba t\u0142umaczenia \ud83d\ude42<\/p>\n
Skrypt si\u0119 sko\u0144czy\u0142.. A gdzie tag zamykaj\u0105cy skrypt php? Nie jest on wymagany. A poniewa\u017c plik kt\u00f3ry napisalismy ma by\u0107 \u0142adowany do innego pliku, wszelkie spacje czy inne bia\u0142e znaki by\u0142y by bardzo niepo\u017c\u0105dane, A takie zosta\u0142y by wczytane gdyby wyst\u0105pi\u0142y po “?>”. Jest to praktyka przyj\u0119ta w Joomla 1.5, i b\u0119dziemy j\u0105 stosowa\u0107 za ka\u017cdym razem.<\/p>\n
Pi\u0119knie – skrypt napisany. Ale co z tego? jak go teraz wgra\u0107 aby by\u0142 dost\u0119pny z poziomu panelu administracyjnego? W Joomli s\u0142u\u017c\u0105 do tego pliki instalacyjne XML.<\/p>\n
Plik instalacyjny<\/h2>\n
nasz plik instalacyjny b\u0119dzie wygl\u0105da\u0142 tak:<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<install type=\"module\" version=\"1.5.0\">\r\n\t<name>Hello World<\/name>\r\n\t<author>Maciej Mucha - www.morony.pl<\/author>\r\n\t<creationDate>December 2008<\/creationDate>\r\n\t<copyright>Maciej Mucha - www.morony.pl<\/copyright>\r\n\t<license>http:\/\/www.gnu.org\/licenses\/gpl-2.0.html GNU\/GPL\r\n              <\/license>\r\n\t<authorEmail>maciej@morony.pl<\/authorEmail>\r\n\t<authorUrl>http:\/\/www.morony.pl<\/authorUrl>\r\n\t<version>1.5.0<\/version>\r\n\t<description>Modu\u0142 s\u0142u\u017c\u0105cy do wy\u015bwietlenia \r\n               informacji \"Hellow World\"<\/description><\/span><\/pre>\n
\t<files>\r\n\t\t<filename module=\"mod_hello\">mod_hello.php<\/filename>\r\n\t\t<filename module=\"mod_hello\">index.html<\/filename>\r\n\t<\/files>\r\n<\/install><\/span><\/pre>\n
O co tu chodzi? To proste, najpierw podajemy kilka informacji o sobie i o skrypcie kt\u00f3re b\u0119d\u0105 widoczne w panelu admina, oraz list\u0119 plik\u00f3w, kt\u00f3re instalator przekopiuje na dysk.<\/p>\n
Co jest wa\u017cne:<\/p>\n
\u00a0<\/p>\n