Categorie Pagina
Panoramica
Dalla versione 3.1.4 di SelfComposer è possibile creare delle categorie, con le relative opzioni, per suddividere le pagine. Ogni categoria ha un suo contenuto e una serie di opzioni che possono avere: un titolo, un'immagine e una descrizione. Ad ogni pagina possono essere associate più opzioni, anche di categorie diverse, attraverso l'utilizzo della tab Relazioni.
Per creare una categoria è possibile farlo nel pannello in "Categorie > Categorie pagina", e per ognuna oltre al contenuto si possono aggiungere un numero illimitato di opzioni.
Le categorie e le loro pagine associate possono essere mostrate come relazione in una pagina (ad esempio per creare dei "prodotti correlati") o direttamente nel tema, come descritto nel paragrafo successivo. È anche possibile effettuare una ricerca di pagine in base alle categorie utilizzate, con il form di Ricerca Categorie.
Implementazione
Estrarre categorie e opzioni
Per estrarre alcune categorie scelte sono disponibili una varietà di funzioni che ne permettono la ricerca. L'array delle categorie possono essere estratte in base al tipo, nel nostro caso "page"
, con la funzione get_categories_by_type()
che accetta l'unico parametro type
con valore di default "product"
.
Le categorie sono estraibili anche in base ad un array di nomi, utilizzando get_categories_by_name()
con i parametri:
nome | tipo | descrizione | valore di default |
---|---|---|---|
categories | array | Array contenente stringhe con i nomi delle categorie cercate | OBBLIGATORIO |
type | string | Tipo delle categorie da estrarre, per estrarre categorie pagina va inserito "page" | 'product' |
Queste funzioni estraggono l'oggetto di una categoria che è formato da queste proprietà:
nome | tipo | descrizione |
---|---|---|
id | int | Id della categoria |
sequence | float | Numero che indica la sequenza di ordinamento della categoria |
name | string | Nome della categoria |
type | string | Tipo della categoria |
created_at | string - date | Data di creazione |
updated_at | string - date | Data di aggiornamento |
options | oggetto | Oggetto contenente le opzioni di questa categoria |
title | string | Titolo della categoria |
description | string | Descrizione della categoria |
Dall'array options
di una categoria è quindi possibile ottenere le opzioni contenute in essa, in alternativa è possibile accedere a più opzioni (anche di categorie diverse) direttamente con la funzione get_options_from_items()
.
Questa estrae le opzioni associate alle pagine che vengono passate tramite un array di oggetti alla proprietà items
.
Inoltre, dalla versione 3.1.5, utilizzando la funzione get_options_hierarchy()
è possibile ottenere l'albero delle opzioni a partire da una scelta, i suoi parametri sono:
nome | tipo | descrizione | valore di default |
---|---|---|---|
option | oggetto - opzione | Opzione di partenza per estrarre l'albero | OBBLIGATORIO |
level | int | Numero di livelli dell'albero da estrarre, se non specificato vengono estratti tutti | null |
type | int | Tipo delle categorie, le categorie pagina inserire "page" | "product" |
Estrarre le pagine associate a categorie o opzioni
Per ottenere le pagine associate ad una o più categorie, di cui si conosce il nome, è possibile usare la funzione get_items_from_categories_name()
con i seguenti parametri:
nome | tipo | descrizione | valore di default |
---|---|---|---|
names | array | L'array contenente le stringhe dei nomi delle categorie scelte | OBBLIGATORIO |
paginate | num | Contenuti da mostrare per ogni paginazione, se vuoto i contenuti non vengono paginati | null |
type | string | Tipo delle categorie scelte, per le categorie pagina inserire "page" | 'product' |
In modo simile è possibile estrarre le pagine da una serie di opzioni di cui si conosce il nome, utilizzando get_items_from_options_name()
che ha gli stessi parametri della funzione precedente.