Il est particulièrement agréable lorsque l'on surfe sur un site, de faire suivre facilement un article qui pourrait éventuellement intéresser un ou plusieurs de ses amis, collègues, etc. TYPO3 offre bien évidemment cette fonctionnalité grâce à l'extension tipafriend.

Vérifiez tout d'abord l'installation de l'extension tipafriend dans Frontend Plugins.

Il y a deux façons d'intégrer l'extension sur votre site :

• soit dans le gabarit de votre site
• soit en tant qu'objet de contenu dans une de vos pages

Dans tous les cas, sachez que le gabarit propre à l'extension se situe dans EXT:tipafriend/pi/ où EXT est le chemin d'installation de l'extension (typo3conf par exemple). Cependant, rien ne vous empêche de copier/coller ce gabarit et de la placer dans un répertoire enfant de fileadmin.

Je vous laisse le soin de jeter un oeil au gabarit standard tipafriend_template.tmpl. On notera  le marqueur ###TEMPLATE_TIPFORM### qui délimite le formulaire de soumission du lien, ###TEMPLATE_TIPFORM_SENT### pour la confirmation et ###TEMPLATE_EMAIL### pour le contenu du mail.

Intégration du plugin tipsafriend dans un template

Dans les constantes du gabarit de votre site :

# Activates Tip a Friend
plugin.tipafriend.file.templateFile = fileadmin/template/site-typo3/tipafriend/tipafriend_template.tmpl
plugin.tipafriend.color1 =
plugin.tipafriend.color2 =
plugin.tipafriend.color3 =
plugin.tipafriend.wrap1 =  |
plugin.tipafriend.wrap2 =  |

Créer le gabarit suivant :

temp.tipafriend = USER
temp.tipafriend {
userFunc = tx_tipafriend->main_tipafriend
templateFile = fileadmin/template/site-typo3/tipafriend/tipafriend_template.tmpl
code = TIPLINK
typolink.parameter = 878

}

à inclure dans votre gabarit principal :

# Marqueur dans le gabarit TS
marks.ENVOYERAMI = TEXT
marks.ENVOYERAMI < temp.tipafriend

NB : 878 est l'id d'une page contenant le plugin tipafriend (code TIPFORM)

Intégration du plugin tipsafriend en tant qu'objet de contenu dans une page

Voici le code à insérer dans les constantes du gabarit de votre site :

# Activates Tip a Friend
plugin.tipafriend.color1 =
plugin.tipafriend.color2 =
plugin.tipafriend.color3 =
plugin.tipafriend.wrap1 =  |
plugin.tipafriend.wrap2 =  |

plugin.tipafriend.PIDtipForm = 179
plugin.tipafriend.file.templateFile = fileadmin/template/site-typo3/tipafriend/tipafriend_template.tmpl

Dans include static, sélectionner plugin.tipafriend [DEPRECATED]

Dans le contenu d'une page, insérer le plugin tipafriend avec le code TIPLINK. Pour info, plugin.tipafriend.PIDtipForm est la page contenant le formulaire.

L'extension tipafriend fonctionne etroitement avec l'extension Captcha.