Piszemy moduł do sklepu Prestashop

Moduł HTML Shortcode jest zaprojektowany, aby umożliwić administratorom PrestaShop tworzenie i zarządzanie krótkimi kodami HTML, które mogą być następnie używane na stronach produktów oraz stronach CMS. Takie rozwiązanie pozwala na łatwe wstawianie powtarzalnych fragmentów kodu HTML, co znacznie upraszcza zarządzanie treścią na stronie internetowej.

Cechy modułu

1. Tworzenie krótkich kodów HTML: Administrator może tworzyć krótkie kody HTML, które mogą być używane w różnych miejscach na stronie.
2. Integracja z CMS: Krótkie kody mogą być wstawiane na stronach CMS, co pozwala na dynamiczne zarządzanie treścią.
3. Integracja z produktami: Krótkie kody mogą być używane na stronach produktów, umożliwiając dodanie niestandardowego HTML bez konieczności edytowania szablonów.
4. Zgodność z wersjami PrestaShop: Moduł jest zgodny z wersją PrestaShop 1.7.0.0 i nowszymi, co zapewnia jego szeroką dostępność.

Początek kodu

class HTMLShortcode extends Module
{
// Deklaracja podstawowych właściwości modułu
public function __construct()
{
$this->name = 'htmlshortcode’;
$this->tab = 'front_office_features’;
$this->version = '1.0.0′;
$this->author = 'Twoje Imię’;
$this->need_instance = 0;

parent::__construct();

Czytaj również:

Kiedy poprawka jest poprawką, a kiedy nową usługą? Jak uniknąć konfliktów między klientem a wykonawcą

Tomasz • 21 listopada 2025

// Ustawienie nazwy wyświetlanej i opisu modułu
$this->displayName = $this->l(’HTML Shortcode’);
$this->description = $this->l(’Allows administrators to create HTML shortcodes to be used on product or CMS pages.’);

// Zgodność wersji PrestaShop
$this->ps_versions_compliancy = array(’min’ => '1.7.0.0′, 'max’ => _PS_VERSION_);
}

// Funkcja instalacyjna modułu
public function install()
{
return parent::install() &&
$this->registerHook(’displayHeader’) &&
$this->registerHook(’displayCMSContent’) &&
$this->registerHook(’displayProductAdditionalInfo’) &&
$this->installDB() &&
$this->installTab();
}

// Dodatkowe funkcje instalacyjne, jeśli są wymagane
private function installDB()
{
// Przykład: tworzenie tabeli w bazie danych
$sql = 'CREATE TABLE IF NOT EXISTS `’._DB_PREFIX_.’htmlshortcode` (
`id_htmlshortcode` int(10) unsigned NOT NULL auto_increment,
`shortcode` varchar(255) NOT NULL,
`html` text NOT NULL,
PRIMARY KEY (`id_htmlshortcode`)
) ENGINE=’._MYSQL_ENGINE_.’ DEFAULT CHARSET=utf8;’;

return Db::getInstance()->execute($sql);
}

private function installTab()
{
// Przykład: dodawanie zakładki do panelu administracyjnego
$tab = new Tab();
$tab->active = 1;
$tab->class_name = 'AdminHTMLShortcode’;
$tab->name = array();
foreach (Language::getLanguages(true) as $lang)
$tab->name[$lang[’id_lang’]] = 'HTML Shortcode’;
$tab->id_parent = (int)Tab::getIdFromClassName(’AdminParentModulesSf’);
$tab->module = $this->name;
$tab->icon = 'icon-code’;

return $tab->add();
}
}

Wyjaśnienie kodu:

Deklaracja właściwości modułu:

$this->name = 'htmlshortcode’; – Ustawia nazwę modułu.
$this->tab = 'front_office_features’; – Ustawia kategorię modułu w back office.
$this->version = '1.0.0′; – Ustawia wersję modułu.
$this->author = 'Twoje Imię’; – Ustawia autora modułu.
$this->need_instance = 0; – Określa, czy instancja modułu jest wymagana.

Konstruktor (__construct)

Wywołuje konstruktor nadrzędny przy użyciu parent::__construct().
Ustawia nazwę wyświetlaną i opis modułu przy użyciu $this->l(), co umożliwia tłumaczenie tych ciągów.

Zgodność wersji PrestaShop

$this->ps_versions_compliancy – Ustawia minimalną i maksymalną wersję PrestaShop, z którą moduł jest zgodny.

Metoda instalacyjna (install)

Rejestruje haki

(displayHeader, displayCMSContent, displayProductAdditionalInfo).
Wywołuje dodatkowe funkcje instalacyjne (installDB, installTab).

Funkcje dodatkowe

installDB() – Przykład funkcji, która tworzy tabelę w bazie danych.
installTab() – Przykład funkcji, która dodaje nową zakładkę do panelu administracyjnego.

Ten kod tworzy moduł PrestaShop, który pozwala administratorom tworzyć krótkie kody HTML do użycia na stronach produktów lub CMS. Część dotycząca instalacji rejestruje odpowiednie haki i wykonuje dodatkowe czynności, takie jak tworzenie tabel w bazie danych i dodawanie zakładki do panelu administracyjnego.