[woof_slideout]

Lo shortcode [woof_slideout] crea un pannello filtro a comparsa che appare dal bordo dello schermo. È una soluzione salvaspazio che mantiene il filtro nascosto fino a quando l'utente ne ha bisogno — ideale per dispositivi mobili, pagine di archivio prodotti o qualsiasi layout in cui lo spazio sullo schermo è limitato.

Il pannello a comparsa supporta sia attivatori immagine che testo, animazione configurabile, comportamento specifico per dispositivi mobili e trasmette tutti gli attributi sconosciuti allo shortcode interno [woof].

Attributi

Attributo	Predefinito	Descrizione
`image`	Icona predefinita del plugin	URL dell'immagine attivatore. Imposta su `null` per usare invece un pulsante di testo.
`image_h`	`50`	Altezza dell'immagine attivatore in pixel
`image_w`	`50`	Larghezza dell'immagine attivatore in pixel
`action`	`click`	Azione attivatore: `click` o `hover`
`location`	`right`	Posizione di apertura: `left`, `right`, `top` o `bottom`
`speed`	`100`	Velocità dell'animazione in millisecondi
`offset`	`100px`	Offset dall'alto (per posizione sinistra/destra) o da sinistra (per posizione superiore/inferiore). Supporta px, %, em, ecc.
`onloadslideout`	`true`	Indica se il pannello deve essere aperto al caricamento della pagina (`true` o `false`)
`mobile_behavior`	`0`	Controllo visibilità: `0` = mostra su tutti i dispositivi, `1` = mostra solo su mobile, `2` = mostra solo su desktop
`width`	`auto`	Larghezza del pannello (es. `350px`, `30%`, `auto`)
`height`	`auto`	Altezza del pannello (es. `500px`, `auto`)
`text`	`Filter`	Testo del pulsante visualizzato quando `image` è impostato su `null`. Usato anche come etichetta della maniglia.
`class`	`''`	Classe CSS aggiuntiva per il contenitore a comparsa
`redirect`	`''`	URL di reindirizzamento dopo l'applicazione del filtro

Utilizzo base


[woof_slideout]

Visualizza un pannello filtro a comparsa dal lato destro con impostazioni predefinite. Il pannello contiene il filtro standard [woof].

Apertura da sinistra


[woof_slideout location="left" speed="300" width="400px"]

Si apre dal lato sinistro con un'animazione di 300ms e una larghezza del pannello di 400px.

Pulsante di testo invece dell'immagine


[woof_slideout image="null" text="Filter Products"]

Usa un pulsante di testo ("Filtra prodotti") invece di un'immagine come maniglia attivatore.

Filtro solo per mobile


[woof_slideout mobile_behavior="1" location="bottom" height="80%"]

Il pannello a comparsa appare solo sui dispositivi mobili, dal basso, occupando l'80% dell'altezza dello schermo. Perfetto per design mobile-first.

Apertura automatica al caricamento con attivatore hover


[woof_slideout onloadslideout="true" action="hover" speed="200"]

Il pannello è aperto per impostazione predefinita e risponde al passaggio del mouse (non al clic). Animazione in 200ms.

Avanzato: contenuto personalizzato all'interno


[woof_slideout location="right" width="350px"]
  [woof taxonomies="product_cat" sid="slideout-cat"]
[/woof_slideout]

Qualsiasi contenuto inserito tra i tag di apertura e chiusura viene utilizzato come contenuto del pannello a comparsa. In questo esempio, uno shortcode specifico [woof] con filtro per tassonomia di categoria è inserito all'interno del pannello.

Passaggio di attributi allo shortcode [woof] interno


[woof_slideout location="left" taxonomies="product_cat" sid="sidebar-filter" by_text="1"]

Gli attributi che non fanno parte del pannello a comparsa stesso (taxonomies, sid, by_text, ecc.) vengono automaticamente inoltrati allo shortcode interno [woof]. Ciò significa che qualsiasi attributo [woof] funziona in modo trasparente.

Solo desktop con offset


[woof_slideout location="right" offset="200px" mobile_behavior="2" width="320px"]

Visibile solo su desktop, posizionato a destra con un offset di 200px dall'alto, largo 320px.

Esempio PHP: sovrascrivere il template del pannello a comparsa

Puoi sovrascrivere il template del pannello a comparsa posizionando un file in:


wp-content/themes/your-theme/woof/ext/slideout/views/shortcodes/woof_slideout.php

Oppure filtrare programmaticamente il comportamento del pannello:


add_filter('woof_slideout_options', function($options) {
    if (is_product_category()) {
        $options['width'] = '100%';
        $options['location'] = 'bottom';
    }
    return $options;
});

Note

L'estensione del pannello a comparsa deve essere abilitata nelle impostazioni del plugin HUSKY affinché lo shortcode funzioni.
Quando si utilizza un'immagine come attivatore, la dimensione consigliata è di circa 50×50 pixel.
L'attributo redirect, se impostato, reindirizzerà la pagina all'URL specificato dopo la selezione dei valori del filtro.
Sono supportate più istanze del pannello a comparsa sulla stessa pagina — ciascuna ottiene una chiave univoca.