Configuration de l'extension ab_downloads (suite)

##################################
# Configuration abdownloads plugin
#
# plus d'options dans le fichier
# typo3conf/ext/ab_downloads/static/css_based/constants.txt

plugin.tx_abdownloads_pi1 {

// Template used
file.templateFile = fileadmin/template/ab_downloads/tx_abdownloads_pi1_css.html

# cat=plugin.tx_abdownloads_pi1//7; type=int+; label= List limit: The maximum number
of downloads shown per category.
listLimit = 5

# cat=plugin.tx_abdownloads_pi1//5; type=text; label= Date format: The date format.
date_stdWrap.strftime = %d/%m/%Y

## LINKS AND TARGETS
# cat=plugin.tx_abdownloads_pi1/links/1; type=text; label= Starting Point
(sysfolderList): The PID of the page (or comma separated list pf PIDs) where your
categories/downloads are located.
sysfolderList = 43

}

Voici quelques explications :

La valeur file.templateFile correspond au template utilisé par l'extension, listLimit force l'affichage à 5 téléchargements par page, date_stdWrap.strftime quand à elle spécifie le format de la date et enfin, SysfolderList indique le dossier système contenant les catégories et les téléchargements.

Vous devez bien sûr avoir créé au préalable un dossier système contenant vos catégories et vos téléchargements. Vous pouvez également utiliser un dossier système pour les catégories et un autre pour les téléchargements afin de mieux séparer les enregistrements dans le backend de TYPO3. Dans ce cas, il faudra lister les répertoires dans la constante plugin.tx_abdownloads_pi1.SysfolderList

4. Insertion du plugin

L'insertion du plugin est simple comme tout autre plugin pour TYPO3. La configuration peut également se faire au niveau du plugin en passant par les tabulations du flexforms.

Nous avons les options suivantes :
- General settings : utilisé principalement pour le type d'affichage
List
Tree
Catalog (détail)
Search : Simple moteur de recherche
Top
- Template pour indiquer le template html utilisé
- Display settings pour les options d'affichage
- Image settings pour la configuration des images définissant les catégories
- TOP settings permet de configurer la 'top' liste, c'est à dire les fichiers les plus téléchargés, les fichiers les plus récents, les fichiers les mieux notés...
- Catalog settings

Je ne détaillerai pas les options car elles sont assez explicites.

La méthode que je recommande consiste à tester les différentes options du plugin et à modifier à votre guise le template htmlde l'extension en prenant soin de ne pas supprimer les marqueurs obligatoires qui délimitent les différents modes d'affichage (List, Tree, etc). Vous pouvez également désactiver le cache sur votre page. Les téléchargements ne seront pas indéxés mais l'extension propose un moteur de recherche intégré.

Le plugin est posé mais il n'affichera pas grand chose. En effet, nous n'avons créé aucun enregistrement dans notre sysfolder. Rendez-vous dans ce dossier et passer en mode liste. Ensuite, cliquez sur 'Créer un nouvel enregistrement'. Vous devriez apercevoir les types 'Modern Downloads Download' et Modern Downloads Category'.

En ce qui concerne les catégories à définir, le masque de saisie est relativement simple puisque vous devrez saisir seulement deux informations, à savoir un nom et une description ; vous pouvez également ajouter une image pour symboliser une catégorie. L'image permet en effet d'afficher en frontend une image à la place du nom de la catégorie. Si le site est multilingue, le problème ne se pose pas car vous pouvez définir une langue pour chaque catégorie (option langue dans le flexform de chaque catégorie). Il est également possible de définir une catégorie parent.