Categorie Pagina

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.

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
namesarrayL'array contenente le stringhe dei nomi delle categorie scelteOBBLIGATORIO
paginatenumContenuti da mostrare per ogni paginazione, se vuoto i contenuti non vengono paginatinull
typestringTipo 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.