Gabarits

Vous pouvez paramétrer les gabarits des différents éléments gérés par HostedVideoAlbums (ou HVA).

Toutes les modifications de gabarits doivent être faites sur un nouveau gabarit car les gabarits par défaut (nommés Sample) sont susceptibles d'être modifiés à chaque version. Lorsque vous créez un nouveau gabarit, il est automatiquement rempli d'une copie du gabarit par défaut.

Gabarits de catégories

Par défaut, pour le niveau catégorie, le gabarit fourni affiche dans une liste à puces, pour chaque catégorie, le nom de la catégorie et sa description. Le nom est un lien hypertexte vers la page affichant tous les albums de la catégorie. Pour modifier ce gabarit, aller dans l'onglet Gabarits de catégories de la page d'administration de HVA.

Variables Smarty pour le gabarit de liste de categories: $leveltitle, $parentobj (si le parent est spécifié), $itemlist (tableau d'items), $item->is_selected, $item->nbchildren (si chargé), $item->name, $item->alias, $item->detaillink, $item->detailurl, $item->description, $item->isdefault, $item->date_modified, $item->date_created

Gabarits d'albums

Par défaut, au niveau album, le gabarit affichera dans une liste à puces, pour chaque album de la catégorie, le nom de l'album et sa description. Le nom est un lien hypertexte vers la page affichant toutes les vidéos de l'album. Pour modifier ce gabarit, aller dans l'onglet Gabarits d'albums de la page d'administration de HVA.

Variables Smarty pour le gabarit de liste d'albums: $leveltitle, $parentobj (si le parent est spécifié), $itemlist (tableau d'items), $item->is_selected, $item->nbchildren (si chargé), $item->name, $item->alias, $item->detaillink, $item->detailurl, $item->description, $item->lang, $item->default_width, $item->default_height, $item->parent_id, $item->parent_alias, $item->parent_name, $item->parentlink, $tiem->parenturl, $item->isdefault, $item->date_modified, $item->date_created

Gabarits de video

Au niveau vidéo, vous pouvez choisir entre 4 modes d'affichage des vidéos d'un album: List Links, List Videos, Fancybox et Awkward Showcase.

• Awkward showcase affiche la vidéo par défaut dans une boîte et en dessous les autres vidéos sous forme de vignettes. En cliquant sur une vignette, la vidéo sélectionnée apparaîtra et démarrera.
• Fancybox (qui est le choix par défaut) affiche les vidéos sous forme de vignettes. En cliquant sur une vignette, une fancybox apparaîtra et jouera la vidéo. Sur la fancybox, des flèches gauche et droite permettent de passer à la vidéo suivante ou précédente.
• List Videos affichera directement dans la page de l'album, pour chaque vidéo de l'album, le nom de la vidéo, sa description et la vidéo elle-même.
• List Links affiche, comme pour category et album, dans une liste à puces, pour chaque vidéo de l'album, le nom de la vidéo et sa description. Le nom est un lien hypertexte vers la page affichant la vidéo qui est affichée en utilisant le «Gabarit d'affichage d'une vidéo en mode 'List Links"
  

Pour modifier les gabarits associés au mode basiques (ListVideos & ListLinks), aller dans l'onglet Gabarits de Vidéos, repérer le template à modifier et créer un nouveau gabarit.

 Variables Smarty pour le gabarit de liste de vidéos: $leveltitle, $parentobj (si le parent est spécifié), $thumbnail_width, $thumbnail_height, $itemlist (tableau d'items), $item->is_selected, $item->name, $item->alias, $item->detaillink, $item->detailurl, $item->description, $item->site, $item->site_namevalue, $item->videoid, $item->width, $item->height, $item->parent_id, $item->parent_alias, $item->parent_name, $item->parentlink, $item->parenturl, $item->isdefault, $item->fancyurl, $item->thumbnail, $item->date_modified, $item->date_created

Variables Smarty pour le gabarit d'affichage d'une vidéo en mode ListLinks:$leveltitle, $previous_item (si chargé), $next_item (si chargé), $item->name, $item->alias, $item->description, $item->site, $item->site_namevalue, $item->videoid, $item->width, $item->height, $item->parent_id, $item->parent_alias, $item->parent_name, $item->parentlink, $item->parenturl, $item->isdefault, $item->date_modified, $item->date_created, $labels->...

Vous pouvez utiliser l'objet $labels pour afficher les étiquettes de champs selon la langue ($labels->nom_du_champ) et accéder aux objets parents en utilisant $item->parent_object->parent_object->... (et ainsi de suite)

Pour modifier le gabarit associé au mode "Fancybox" (resp. Awkward Showcase), aller dans l'onglet Gabarits pour Fancybox (resp. Awkward Showcase).  Attention, pour es deux cas, il y a à chaque fois 2 gabarits. Le premier gère l'entête qui permettra de définir les aspects communs à toutes les vidéos de la page (import javascript + code de mise en oeuvre spécifique) et le second gère l'insertion de la liste de vidéos dans la page.

Imbrication d'une vidéo dans un des gabarits

Les différents gabarits de HVA utilisent un gabarit commun d'insertion de vidéos appelé par la balise {HostedVideoAlbums_embedvideo item=$item}. Le paramètre item=$item est obligatoire. A l'intérieur du gabarit associé à cette balise (dans l'onglet Gabarits de vidéos, c'est le "gabarit à utiliser pour imbriquer une vidéo") , vous pouvez utiliser les champs suivants: $leveltitle, $rooturl, $item->name, $item->alias, $item->description, $item->site, $item->site_namevalue, $item->videoid, $item->width, $item->height, $item->lang, $item->parent_id, $item->parent_alias, $item->parent_name, $item->parentlink, $item->parenturl, $item->isdefault, $item->date_modified, $item->date_created, $item->color1, $item->color2, $item->scriptaccess, $item->fullscreen, $item->autoplay, $item->fullscreen_int (comme fullscreen mais 1 au lieu de true), $item->autoplay_int (comme autoplay mais 1 au lieu de true), $labels->...

Gabarits de vignettes

Depuis la version 2.4, il est possible de gérer le gabarit des vignettes à partir de l'onglet "Gabarits pour vidéos". Dans ce gabarit, un peu de code smarty3 permet de récupérer l'url de la vignette pour les différents sites répertoriés dans HVA. Si vous utilisez un nouveau site, il vous faudra ajouter du code à ce gabarit pour gérer les vignettes si celles ci peuvent être déterminées dynamiquement. Pour les cas où les vignettes sont assignées "à la main" aux vidéos de ce site, il n'y a rien à faire.

Pour insérer la vignette d'une vidéo dans un gabarit, utiliser la balise {HostedVideoAlbums_embedthumbnail width="{$thumbnail_width}" height="{$thumbnail_height}" videoid="{$item->videoid}" site="{$item->site_namevalue}" static="{$item->thumbnail}" }

Breadcrumbs (Chemins de fer)

Lorsque vous êtes dans un gabarit de module, vous pouvez appeler les breadcrumbs en utilisant la balise{HostedVideoAlbums_breadcrumbs}. Vous pouvez utiliser les mêmes paramètres que dans la balise breadcrumbs du cms (initial, delimiter, classid, currentclassid), de même que le paramètre "startlevel".
En dehors des gabarits de module, n'importe où sur la page, vous pouvez appeler l'action breadcrumbs {cms_module module="HostedVideoAlbums"action="breadcrumbs"}, utilisant les mêmes paramètres.