{"id":18401,"date":"2025-01-30T14:09:01","date_gmt":"2025-01-30T13:09:01","guid":{"rendered":"https:\/\/www.lh.pl\/pomoc\/?p=18401"},"modified":"2025-01-30T14:09:02","modified_gmt":"2025-01-30T13:09:02","slug":"jak-zaczac-tworzyc-moduly-do-prestashop","status":"publish","type":"post","link":"https:\/\/www.lh.pl\/pomoc\/jak-zaczac-tworzyc-moduly-do-prestashop\/","title":{"rendered":"Jak zacz\u0105\u0107 tworzy\u0107 modu\u0142y do PrestaShop?"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

Czym s\u0105 modu\u0142y w PrestaShop i dlaczego warto je tworzy\u0107?<\/h2>\n\n\n\n

Modu\u0142y w PrestaShop to rozszerzenia, kt\u00f3re umo\u017cliwiaj\u0105 dostosowanie sklepu do indywidualnych potrzeb. Dzi\u0119ki nim mo\u017cesz dodawa\u0107 nowe funkcje, integrowa\u0107 zewn\u0119trzne systemy, modyfikowa\u0107 wygl\u0105d strony czy usprawnia\u0107 dzia\u0142anie sklepu bez ingerencji w kod \u017ar\u00f3d\u0142owy platformy. Modu\u0142y dzia\u0142aj\u0105 niezale\u017cnie, co sprawia, \u017ce s\u0105 \u0142atwe w zarz\u0105dzaniu i aktualizacji.<\/p>\n\n\n\n

Dlaczego warto tworzy\u0107 modu\u0142y? <\/strong>Przede wszystkim dlatego, \u017ce pozwalaj\u0105 one wprowadza\u0107 spersonalizowane rozwi\u0105zania, kt\u00f3re wyr\u00f3\u017cni\u0105 Tw\u00f3j sklep na tle konkurencji. Dla w\u0142a\u015bcicieli sklep\u00f3w to szansa na unikalne funkcje, a dla programist\u00f3w \u2013 okazja do rozwijania swoich umiej\u0119tno\u015bci i tworzenia warto\u015bciowych rozwi\u0105za\u0144, kt\u00f3re mog\u0105 by\u0107 sprzedawane jako produkty na platformach takich jak PrestaShop Addons.<\/p>\n\n\n\n

Aby rozpocz\u0105\u0107 prac\u0119 nad modu\u0142ami, wystarczy podstawowa znajomo\u015b\u0107 PHP, HTML, CSS, JavaScript oraz MySQL. CSS i JavaScript pozwalaj\u0105 na tworzenie atrakcyjnych i interaktywnych element\u00f3w, kt\u00f3re mo\u017cna zintegrowa\u0107 z funkcjami modu\u0142u. MySQL z kolei umo\u017cliwia zarz\u0105dzanie danymi w bazie, co jest szczeg\u00f3lnie przydatne w przypadku bardziej zaawansowanych modu\u0142\u00f3w, takich jak integracje z zewn\u0119trznymi systemami czy dynamiczne raporty.<\/p>\n\n\n\n

Nie musisz by\u0107 ekspertem w tych technologiach \u2013 wystarczy znajomo\u015b\u0107 podstaw, kt\u00f3re b\u0119d\u0105 rozwijane wraz z post\u0119pem prac nad modu\u0142em. W tym poradniku znajdziesz wszystkie niezb\u0119dne kroki, kt\u00f3re pomog\u0105 Ci stworzy\u0107 sw\u00f3j pierwszy modu\u0142 i w pe\u0142ni wykorzysta\u0107 mo\u017cliwo\u015bci PrestaShop.<\/strong><\/p>\n\n\n\n

Podstawowa struktura modu\u0142u<\/h2>\n\n\n\n

Ka\u017cdy modu\u0142 w PrestaShop opiera si\u0119 na precyzyjnie zdefiniowanej strukturze plik\u00f3w i folder\u00f3w, kt\u00f3ra umo\u017cliwia jego prawid\u0142owe dzia\u0142anie w systemie. Zrozumienie tej struktury to kluczowy krok w procesie tworzenia w\u0142asnych modu\u0142\u00f3w.<\/p>\n\n\n\n

Tworzenie katalogu modu\u0142u<\/h3>\n\n\n\n

Pierwszym krokiem jest utworzenie katalogu dla modu\u0142u w folderze \/modules\/ Twojej instalacji PrestaShop. Nazwa katalogu powinna by\u0107 unikalna i oparta na konwencji, np. mymodule. Wa\u017cne jest, aby u\u017cywa\u0107 wy\u0142\u0105cznie ma\u0142ych liter i unika\u0107 spacji.<\/p>\n\n\n\n

Plik g\u0142\u00f3wny modu\u0142u<\/h3>\n\n\n\n

Kluczowym plikiem ka\u017cdego modu\u0142u jest plik PHP, kt\u00f3rego nazwa musi odpowiada\u0107 nazwie katalogu modu\u0142u, np. mymodule.php<\/strong>. Plik ten zawiera klas\u0119 modu\u0142u, kt\u00f3ra dziedziczy po klasie Module dostarczonej przez PrestaShop. W tej klasie definiowane s\u0105 wszystkie podstawowe informacje o module, takie jak nazwa, opis czy wersja.<\/p>\n\n\n\n

Przyk\u0142ad podstawowego pliku g\u0142\u00f3wnego mymodule.php:<\/strong><\/p>\n\n\n\n

class MyModule extends Module\r\n{\r\n\tpublic function __construct()\r\n\t{\r\n\t\t$this->name = 'mymodule';\r\n\t\t$this->tab = 'front_office_features';\r\n\t\t$this->version = '1.0.0';\r\n\t\t$this->author = 'Twoje Imi\u0119';\r\n\t\t$this->need_instance = 0;\r\n\r\n\t\tparent::__construct();\r\n\r\n\t\t$this->displayName = $this->l('M\u00f3j modu\u0142');\r\n\t\t$this->description = $this->l('Opis modu\u0142u.');\r\n\t}\r\n\r\n\tpublic function install()\r\n\t{\r\n\t\treturn parent::install();\r\n\t}\r\n\r\n\tpublic function uninstall()\r\n\t{\r\n\t\treturn parent::uninstall();\r\n\t}\r\n}\r\n<\/code><\/pre>\n\n\n\n
Kluczowe elementy pliku config.xml<\/h3>\n\n\n\n
Dodatkowo modu\u0142 powinien zawiera\u0107 plik config.xml<\/strong>, kt\u00f3ry przechowuje metadane takie jak kompatybilno\u015b\u0107 z wersjami PrestaShop czy wymagania modu\u0142u. Plik ten nale\u017cy umie\u015bci\u0107 w katalogu g\u0142\u00f3wnym modu\u0142u.<\/p>\n\n\n\n
Przyk\u0142ad zawarto\u015bci config.xml:<\/strong><\/p>\n\n\n\n
<module>\r\n\t<name>mymodule<\/name>\r\n\t<displayName>M\u00f3j modu\u0142<\/displayName>\r\n\t<version>1.0.0<\/version>\r\n\t<description>Opis modu\u0142u.<\/description>\r\n\t<author>Twoje Imi\u0119<\/author>\r\n\t<compatibility>\r\n\t\t<min>1.7.0.0<\/min>\r\n\t\t<max>1.7.8.0<\/max>\r\n\t<\/compatibility>\r\n<\/module>\r<\/code><\/pre>\n\n\n\n
Struktura katalog\u00f3w<\/h3>\n\n\n\n
Przyk\u0142adowa struktura katalogu modu\u0142u:<\/p>\n\n\n\n
mymodule\/\r\n\u251c\u2500\u2500 mymodule.php\r\n\u251c\u2500\u2500 config.xml\r\n\u251c\u2500\u2500 views\/\r\n\u2502   \u251c\u2500\u2500 templates\/\r\n\u2502   \u2502   \u251c\u2500\u2500 front\/\r\n\u2502   \u2502   \u2514\u2500\u2500 admin\/\r\n\u2502   \u251c\u2500\u2500 css\/\r\n\u2502   \u2502   \u2514\u2500\u2500 mymodule.css\r\n\u2502   \u251c\u2500\u2500 js\/\r\n\u2502   \u2502   \u2514\u2500\u2500 mymodule.js\r\n\u2502   \u2514\u2500\u2500 img\/\r\n\u2502\t   \u2514\u2500\u2500 myimage.png\r\n\u2514\u2500\u2500 controllers\/\r\n\t\u251c\u2500\u2500 front\/\r\n\t\u2514\u2500\u2500 admin\/\r<\/code><\/pre>\n\n\n\n
Wszystkie grafiki, kt\u00f3re chcesz wykorzysta\u0107 w module (np. ikony, banery, obrazy do frontendu), powinny by\u0107 przechowywane w katalogu views\/img\/<\/strong>. Dzi\u0119ki temu b\u0119d\u0105 one \u0142atwe do zarz\u0105dzania i mo\u017cna je \u0142atwo za\u0142adowa\u0107 za pomoc\u0105 odpowiednich \u015bcie\u017cek w module.<\/p>\n\n\n\n
Na przyk\u0142ad, aby za\u0142adowa\u0107 obraz w pliku szablonu, mo\u017cesz u\u017cy\u0107 \u015bcie\u017cki:<\/p>\n\n\n\n
<img src=\"{$module_dir}views\/img\/myimage.png\" alt=\"M\u00f3j obraz\" \/><\/code><\/pre>\n\n\n\n
Generowanie podstawy modu\u0142u<\/h2>\n\n\n\n
Proces tworzenia modu\u0142u w PrestaShop mo\u017cna znacz\u0105co upro\u015bci\u0107, korzystaj\u0105c z generator\u00f3w modu\u0142\u00f3w <\/strong>lub tworz\u0105c struktur\u0119 r\u0119cznie. <\/strong>Dzi\u0119ki temu mo\u017cesz szybko rozpocz\u0105\u0107 prac\u0119 nad swoim projektem i skupi\u0107 si\u0119 na dodawaniu unikalnych funkcji.<\/p>\n\n\n\n
Korzystanie z generatora modu\u0142\u00f3w<\/h3>\n\n\n\n
PrestaShop udost\u0119pnia narz\u0119dzie online \u2013 PrestaShop Module Generator<\/strong>, kt\u00f3re umo\u017cliwia automatyczne wygenerowanie podstawowego szkieletu modu\u0142u. Wystarczy wype\u0142ni\u0107 kilka p\u00f3l, takich jak nazwa modu\u0142u, wersja czy autor, a generator utworzy kompletn\u0105 struktur\u0119 plik\u00f3w i folder\u00f3w, gotow\u0105 do dalszej pracy.<\/p>\n\n\n\n
Aby skorzysta\u0107 z generatora:<\/p>\n\n\n\n
    \n
  1. Otw\u00f3rz stron\u0119 PrestaShop Module Generator<\/strong><\/a>.<\/li>\n\n\n\n
  2. Wprowad\u017a wymagane dane, takie jak nazwa modu\u0142u, opis i wersja.<\/li>\n\n\n\n
  3. Pobierz wygenerowany plik ZIP i rozpakuj go w folderze \/modules\/ Twojej instalacji PrestaShop.<\/li>\n<\/ol>\n\n\n\n
    Narz\u0119dzie to idealnie nadaje si\u0119 dla pocz\u0105tkuj\u0105cych, poniewa\u017c eliminuje konieczno\u015b\u0107 r\u0119cznego tworzenia struktury modu\u0142u, a jednocze\u015bnie pozwala szybko rozpocz\u0105\u0107 prac\u0119.<\/p>\n\n\n\n
    R\u0119czne tworzenie struktury modu\u0142u<\/h3>\n\n\n\n
    Je\u015bli wolisz pe\u0142n\u0105 kontrol\u0119 nad procesem, mo\u017cesz stworzy\u0107 modu\u0142 r\u0119cznie. W tym celu:<\/p>\n\n\n\n
    Utw\u00f3rz nowy katalog w folderze \/modules\/ <\/strong>swojej instalacji PrestaShop. Nazwij go np. mymodule<\/strong>.<\/p>\n\n\n\n
    W katalogu utw\u00f3rz plik PHP o nazwie mymodule.php<\/strong>. Ten plik b\u0119dzie zawiera\u0142 klas\u0119 modu\u0142u, kt\u00f3ra dziedziczy po klasie Module.<\/p>\n\n\n\n
    Dodaj plik config.xml <\/strong>z metadanymi modu\u0142u.<\/p>\n\n\n\n
    Utw\u00f3rz foldery, takie jak views\/<\/strong>, controllers\/<\/strong>, czy translations\/<\/strong>, zgodnie z potrzebami modu\u0142u.<\/p>\n\n\n\n
    Rejestrowanie hook\u00f3w i dodawanie funkcji<\/h2>\n\n\n\n
    Hooki w PrestaShop to kluczowy element umo\u017cliwiaj\u0105cy integracj\u0119 modu\u0142\u00f3w z platform\u0105. S\u0142u\u017c\u0105 one do:<\/p>\n\n\n\n