Seconda descrizione della categoria: configurazione e aiuto

Carica lo ZIP in Moduli > "Module Manager" > "Upload a module". Installalo e fai clic su "Configure". Apri "Improve" > Seconda descrizione categoria per accedere alla dashboard, a Modelli e a Impostazioni.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.

L'installazione crea queste tabelle con il prefisso del tuo database:

mprscd_description
mprscd_description_lang
mprscd_injection
mprscd_profile

Scegli il contesto del negozio corretto, poi apri "Catalog" > Categorie e modifica una categoria. Compila Seconda descrizione categoria sotto la descrizione standard. Inserisci contenuti per ogni lingua necessaria e salva.

Nelle versioni di PrestaShop precedenti alla 1.7.7, usa il vecchio form di categoria per inserire la descrizione.

Le descrizioni vengono salvate per categoria e negozio, con record separati per lingua. Una traduzione vuota non comporta l'uso automatico della lingua predefinita. Una pagina senza contenuti salvati per la propria categoria, lingua e negozio non restituisce alcun blocco.

Puoi strutturare i contenuti con titoli, paragrafi, elenchi e link. Per esempio:

<h2>Buying guide for this category</h2>
<p>Explain how to choose between the products in this category.</p>
<h3>What to compare before ordering</h3>
<ul>
  <li>Size or dimensions</li>
  <li>Material or finish</li>
  <li>Compatibility with the rest of the order</li>
</ul>
<h3>Related categories</h3>
<p>Add relevant links to related categories.</p>

Apri Seconda descrizione categoria > Impostazioni > Generale.

Salva le modifiche. Il pannello Posizionamento template contiene un link a Apri gestore template e indica se un'iniezione tracciata è attiva.

Usa l'hook del piè di pagina della categoria

"Default (inside column)" e "Full width (CSS breakout)" mostrano i contenuti tramite displayFooterCategory. Controlla il template della categoria per confermare che l'hook si trovi dove vuoi il blocco.

La larghezza piena aggiunge mprscd-fullwidth. Si tratta di un'espansione tramite CSS che può comunque essere limitata dal layout circostante del tema.

Usa l'iniezione nel template

Apri Modelli e analizza il tema attivo. Controlla il file e la posizione proposti. Conserva una copia del file del tema prima di modificarlo, poi inserisci l'hook tracciato. Seleziona "Template injection" in "Display Mode".

Il marcatore dell'hook inserito è:

{* MPRSCD_INJECT *}{hook h='displayMprSecondCatDesc'}{* /MPRSCD_INJECT *}

Puoi anche posizionare {hook h='displayMprSecondCatDesc'} manualmente. Questo hook personalizzato mostra i contenuti solo quando "Display Mode" è "Template injection". Mostra il blocco a larghezza piena.

In modalità iniezione, un inserimento tracciato attivo mostra la descrizione nella posizione inserita e la nasconde dal normale piè di pagina della categoria. Senza un inserimento tracciato attivo, la descrizione può ancora apparire nel piè di pagina della categoria. Controlla che non ci siano descrizioni duplicate se combini un inserimento manuale con la normale posizione nel piè di pagina.

Dopo aver aggiornato o sostituito un tema, controlla lo stato dell'iniezione e ripeti l'analisi. Il gestore può rimuovere gli inserimenti tracciati.

Apri una categoria con contenuti salvati. Verifica che compaiano nella posizione prevista nel piè di pagina o tramite iniezione. Controlla un'altra lingua e, in multinegozio, un altro contesto del negozio. Apri una categoria senza descrizione salvata e conferma che non compaia un blocco vuoto.

Con "First Page Only" attivo, apri la pagina 2 e verifica che il blocco sia nascosto. L'impostazione usa il numero page nell'URL della categoria. Se il tema usa un formato di paginazione diverso, controlla che il blocco resti nascosto nelle pagine successive.

Il contenitore normale è:

<div class="mprscd-description">
  <div class="mprscd-content">
    <!-- your saved description -->
  </div>
</div>

La modalità a larghezza piena aggiunge mprscd-fullwidth all'elenco delle classi esterne. Adatta gli stili nel tuo tema se necessario:

.mprscd-description {
  margin-top: 2rem;
  background: #fff;
}
.mprscd-description .mprscd-content {
  line-height: 1.7;
}
.mprscd-description.mprscd-fullwidth .mprscd-content {
  max-width: 1170px;
  margin-left: auto;
  margin-right: auto;
}

Se sostituisci "CSS Class", aggiorna di conseguenza i selettori CSS.

Conferma che "Enable Module" sia su Sì, che la categoria sia corretta e che ci siano contenuti salvati per il negozio e la lingua attuali. Controlla "First Page Only" prima di analizzare una pagina successiva della paginazione.

Se mancano contenuti in modalità "Default", conferma che il tema esegua displayFooterCategory. Se mancano in modalità "Template injection", conferma che l'hook personalizzato inserito sia presente nel template attivo. L'hook personalizzato non restituisce nulla nelle altre modalità di visualizzazione o fuori dalle pagine di categoria.

Se i contenuti compaiono due volte, controlla che non siano presenti sia un hook manuale sia una posizione attiva nel piè di pagina. Usa il posizionamento tracciato e controlla lo stato dell'iniezione del modulo dopo le modifiche al tema.

Svuota la cache di pagina o dei template pertinente dopo le modifiche. Usa la pagina "Integrity" del modulo per verificare l'infrastruttura richiesta. La dashboard mostra quante categorie hanno una descrizione.

Le descrizioni restano nel modulo e non vengono copiate nel campo nativo della descrizione aggiuntiva della categoria. Le impostazioni non includono uno strumento di migrazione.

Usa "Enable Module" = No per nascondere le descrizioni senza eliminarle.

Prima di disinstallare, esporta le descrizioni che vuoi conservare. La disinstallazione rimuove le tabelle del modulo, comprese descrizioni salvate, record delle iniezioni e profili. Anche l'eliminazione di una categoria rimuove i corrispondenti record di descrizione del modulo.

La disinstallazione prova prima a rimuovere le iniezioni tracciate nei template. Se la pulizia fallisce, la disinstallazione può proseguire e registrare l'errore. Controlla poi i template del tema modificati e rimuovi eventuali chiamate di hook manuali o tracciate rimaste, se necessario.