dodanie dodatkowego pola opisu w kategorii – Presta Shop 1.6, Presta Shop 1.7 [Aktualizacja]

Domyślnie w danej kategorii opis znajduje się nad listą produktów. Czasem ze względów pozycjonerskich (SEO) zachodzi potrzeba dodania dodatkowego opisu pod produktami. Deklarowanego oddzielnie w edycji lub tworzeniu nowej kategorii.

Presta Shop 1.6 przez swoją innowacyjną budowę pozwala stosunkowo łatwo dodać takie pole. Poniżej szczegóły.

Dodanie pola w bazie danych.

Nasze modyfikacje w plikach były by na nic, gdyby system nie miał gdzie zapisywać tego dodatkowego opisu. Opisy kategorii są trzymane w tabeli ps_category_lang. Dodanie pola realizujemy poprzez zapytanie:

ALTER TABLE `ps_category_lang` ADD `description_alt` TEXT NOT NULL ;

Modyfikacja obiektu Category.

Edytujemy plik:

/classes/Category.php

Na początku klasy PHP: CategoryCore deklarujemy analogiczną do „domyślnego” opisu zmienną. Zastępujemy kod (okolice 40 linii) :

/** @var string Description */
public $description;

/** @var integer Parent category ID */
public $id_parent;

Kodem:

/** @var string Description */
public $description;

/** @var string Alternative Description */
public $description_alt;

/** @var integer Parent category ID */
public $id_parent;

W tym samym pliku odnajdujemy statyczną, publiczną zmienną tablicową $definition;

public static $definition = array(

(okolice 95 linii) i dodajemy do niej kolejny element zamieniając kod:

'description' =>         array('type' => self::TYPE_HTML, 'lang' => true, 'validate' => 'isCleanHtml'),

na:

'description' =>         array('type' => self::TYPE_HTML, 'lang' => true, 'validate' => 'isCleanHtml'),
'description_alt' =>         array('type' => self::TYPE_HTML, 'lang' => true, 'validate' => 'isCleanHtml'),

Modyfikacja kontrolera kategorii.

edytujemy plik:

/controllers/admin/AdminCategoriesController.php

W metodzie konstrukcyjnej __construct() znajdujemy zmienną tablicową $this->fields_list:

$this->fields_list = array(

i dodajemy do niej kolejny element zamieniając kod:

'description' => array(
'title' => $this->l('Description'),
'callback' => 'getDescriptionClean',
'orderby' => false
),

'position' => array(
'title' => $this->l('Position'),
'filter_key' => 'sa!position',
'position' => 'position',
'align' => 'center'
),

na:

'description' => array(
'title' => $this->l('Description'),
'callback' => 'getDescriptionClean',
'orderby' => false
),

'description_alt' => array(
'title' => $this->l('Description Alternative'),
'callback' => 'getDescriptionClean',
'orderby' => false
),

'position' => array(
'title' => $this->l('Position'),
'filter_key' => 'sa!position',
'position' => 'position',
'align' => 'center'
),

(Uwaga dla wersji PrestaShop 1.7 może się to nieznacznie różnić)

W tym samym pliku odnajdujemy publiczną metodę:

renderForm()

(okolice 412 linii) następnie w tej metodzie znajdujemy zmienną tablicową:

$this->fields_form = array(

i dodajemy do niej kolejny element zamieniając kod:

array(
'type' => 'textarea',
'label' => $this->l('Description'),

'name' => 'description',
'autoload_rte' => true,
'lang' => true,
'hint' => $this->l('Invalid characters:').' <>;=#{}'
),

na:

array(
'type' => 'textarea',
'label' => $this->l('Description'),

'name' => 'description',
'autoload_rte' => true,
'lang' => true,
'hint' => $this->l('Invalid characters:').' <>;=#{}'
),

array(
'type' => 'textarea',
'label' => $this->l('Description Alternative'),

'name' => 'description_alt',
'autoload_rte' => true,
'lang' => true,
'hint' => $this->l('Invalid characters:').' <>;=#{}'
),

 

Gotowe, wykonanie powyższych czynności pozwala nam deklarować dodatkowy opis w kategorii. To, jak zostanie on nazwany (w naszym przypadku Alternative Description) zależy tylko od nas, poprzez odpowiednie zmodyfikowanie powyższego kodu. Wygląd pola:

 

Modyfikacja szablonu kategorii.

PrestaShop 1.6:

Pozostało nam tylko zaprezentować dodatkowy opis na sklepie. W tym celu edytujemy plik:

/themes/{NAZWA-SZABLONU}/category.tpl

Nastepnie w miejscu gdzie chcemy aby pojawił się nowy opis wklejamy kod:

{if $category->description_alt && $smarty.get.p < 2}
<div class="cat_desc cat_desc_container clearfix">
{if Tools::strlen($category->description_alt) > 1550}
<div id="category_description_full" class="unvisible rte">{$category->description_alt}</div>
<a href="{$link->getCategoryLink($category->id_category, $category->link_rewrite)|escape:'html':'UTF-8'}" class="lnk_more btn btn-default pull-right"><i class="icon-plus"></i> {l s='More'}</a>
{else}
<div class="rte">{$category->description_alt}</div>
{/if}
</div>
{/if}

Lub krócej:

{if $category->description_alt}

<div class="rte">{$category->description_alt}</div>

{/if}

Jeżeli opis ma być pod listą produktów – musi on sie znaleźć pod wywołaniem tego kodu:

{include file="./product-list.tpl" products=$products}

PrestaShop 1.7:

Otwórz plik:

themes/{szablon}/templates/catalog/listing/product-list.tpl

Na końcu pliku (lub na końcu przed kodem {/block} ) wklej:

  {if $page_name == 'category'}
  
  	{if $category.description_alt && $category.description_alt != ''}
      <div class="block-category">
        <div style="margin-top: 10px;" id="category-description">{$category.description_alt nofilter}</div>
      </div>
    {/if}
  
  {/if}