3. Configuration de l'extension ab_downloads

Les fichiers de l'extension sont localisés dans le répertoire typo3conf/ext/ab_downloads.

On retrouve ici des répertoires très importants pour configurer l'extension. En effet, ces répertoires contiennent des exemples de configurations qui pourront par exemple être chargées depuis la section « Include statics Â» de votre template.

Le répertoire res/ contient par exemple la css de base de l'extension. Vous avez également un exemple de configuration de realurl dans le fichier example_realURL_setup.txt. Il y a également un autre fichier intéressant : example_userPageBrowserFunc.php Il contient un exemple de typoscript permettant d'afficher des images plutôt que d'avoir un lien hypertexte pour toutes les entrées du fichier des traductions locallang,xml (ext/ab_downloads/pi1/locallang.xml). Voici le code :

plugin.tx_abdownloads_pi1 {
# Example for overriding values from locallang.php with
HTML-code displaying images instead of text
_LOCAL_LANG.default {
pi_list_browseresults_prev = <img src="typo3/gfx/pil2left.gif"
border="0" height="12" width="7" alt="previous" title="previous">
pi_list_browseresults_next = <img src="typo3/gfx/pil2right.gif"
border="0" height="12" width="7" alt="next" title="next">
}
}

Pour d'autres valeurs, ouvrez le fichier locallang.xml et repérer l'entrée correspondante. Pour supprimer le lien « Propose a new download » et ajouter une image à la place, nous aurions :

plugin.tx_abdownloads_pi1 {
# Example for overriding values from locallang.php with
HTML-code displaying images instead of text
_LOCAL_LANG.default {
ll_add_download = <img src="fileadmin/images/mon_image.gif"
border="0" alt="Proposez un téléchargement" title="Proposez un téléchargement">
}
}

Très pratique !

Le répertoire static contient des informations sur l'affichage du plugin en frontend :

- static/css/setup.txt pour modifier la css par défaut ou intégrer vos propres styles
- static/css_based contient les instructions en typoscript pour un affichage du plugin sous forme de css (template utilisé : pi1/ tx_abdownloads_pi1_css.tmpl)
- static/table_based/ contient lui, du code Typoscript pour un affichage classique sans css (template utilisé : pi1/tx_abdownloads_pi1.tmpl)

Nous allons nous servir du template css de l'extension localisé à cet endroit : pi1/ tx_abdownloads_pi1_css.tmpl. Je vous recommande de copier-coller ce fichier dans le répertoire fileadmin pour pouvoir le modifier à loisir, En effet, en général, on évite la modification des fichiers directement au niveau de l'extension car les ajouts, modifications de code peuvent être perdus lors d'une mise à jour de l'extension. N'étant pas un amateur de l'extension 'tmpl', je préfère la renommer en 'html'. A titre d'exemple, mon template html se situe dans ce répertoire : fileadmin/template/ab_downloads/