Ce module nécessite l'ouverture d'un compte twitter et la création d'une application Twitter pour l'utilisation des APIs sur votre site.
- Si vous n'avez PAS ces éléments, suivez la procédure I ci-dessous.
I. Procédure Twitter
Inscriptions
Inscrivez vous sur twitter en tant qu'utilisateur ICI.
1. Créez l'application (passerelle entre NPDS et Twitter)ICI.
Pendant la création de l'application, pour les non-anglophones, les infos REQUISES à renseigner sont les suivantes :
App Name : Nom au choix de votre application (Exemple, "Passerelle NPDS-Twi". Seule restriction : Ne doit pas contenir le mot "twitter")
Application description : Idem, saisie libre. Par exemple : "Passerelle NPDS-Twitter"
Tell us how this app will be used : Par exemple : "This application will be used to automatically publish tweets when there is new publication in our CCMS."
Website URL : l'url du site sur lequel vous installez npds_twi
Les autres champs sont facultatifs.
2. Paramétrage de l'application Twitter :
Une fois l'application créée, allez dans l'onglet "Permissions" de l'application.
Dans la section "Application type", pour le paramètre "Access", cochez "Read and write".
Cliquez sur "Update this Twitter application's settings" pour valider.
Cliquez sur l'onglet "Details"
Cliquez sur "Create my access token". Si c'est déjà le cas, cliquez sur "Recreate my access token"
Attention! Cela va modifier les clefs "Access token". Si vous les avez déjà saisies précédemment dans npds_twi, il faut les ressaisir.
3. Récupérez vos clefs et jetons (requis pour le paramétrage de votre module).
4. Vous avez maintenant les élément nécessaires au fonctionnement de cette passerelle :
Votre clef de consommateur (Consumer key)
Votre code secret de consommateur (Consumer secret)
Jeton d'accès pour Open Authentification (Access token)
Jeton d'accès secret pour Open Authentification (Access token secret)
II. Procédure Npds
Allez à l'administration du module /admin.php?op=Extend-Admin-SubModule&ModPath=npds_twi&ModStart=admin/npds_twi_set
Un message vous informera si la publication est autorisé pour le site (par défaut à Non). (pour modifier cette autorisation supérieure suivez le lien) /admin.php?op=Configure
Préferences > Configuration des infos en Backend & Réseaux Sociaux > Activer Twitter
Activez ou pas la publication des news sur twitter
Choisissez un raccourciceur d'url
Remplissez les 4 champs avec les paramètres twitter (cf4) ...
Notes
Si vous souhaitez utiliser npds_twi sur plusieurs sites NPDS, mais avec un seul compte twitter, nous vous conseillons de créer une application twitter par site NPDS. Cela vous permettra d'avoir à chaque fois les url WebSite et Callback correctement renseignées.
Il existe trois solutions implémentées pour raccourcir les urls sans passer par un service extérieur.
Deux de ces solutions (cf.b cf.c) utilisent un fichier .htaccess l'autre est uniquement en php et native pour NPDS (cf.a)
a - La solution recommandée (cochée par défaut) est : Réécriture d'url avec contrôleur Npds.
b - Si vous choisissez: Réécriture d'url avec mod_rewrite
Il vous faut modifier (ou créer s'il n'existe pas) le fichier .htaccess (à la racine de votre site) comme suit :
RewriteEngine on
RewriteRule ^s([0-9]+)$ /article.php?sid=$1[L]
Nota : la première ligne est inutile si elle existe déjà dans votre fichier, la deuxième ligne est requise.
c - Si vous choisissez : Réécriture d'url avec ForceType
Il vous faut modifier (ou créer s'il n'existe pas) le fichier .htaccess (à la racine de votre site) comme suit :
<FilesMatch "^s$">
ForceType application/x-httpd- php
SetHandler application/x-httpd-php
</FilesMatch>