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 ci-dessous.
Procédure Twitter
1. Inscrivez vous sur twitter en tant qu'utilisateur
ICI.
1.1 Inscrivez vous en tant que développeur
ICI.
2. Créez l'application :
2.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.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 paramré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)
5. 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 defaut à 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>
Semiautomatic installation of the module npds_twi
This module requires to open a twitter account and to create a Twitter application for the use of the APIs on your site.
- If you already have these elements, pass directly to the point 6.
- If you have
not these elements, follow the procedure below.
Twitter procedure:
1. Register as user
HERE
1.1 Register as developer
ICI.
2. Create the application:
2.1 Create the application (bridge between NPDS and Twitter)
HERE:
During the creation of the application, informations to enter are:
- App Name: Name of your choice for your application (example, "NDPS-Twi bridge." Only one restriction: Must not contain the word "twitter")
- Application description: Same, free entry. For example: "bridge NPDS-Twitter"
- Website URL: the url of the site on which you install npds_twi
- Tell us how this app will be used: for example : "This application will be used to automatically publish tweets when there is new publication in our CCMS."
- The others fields are not required. .
2.2 Setting the twitter application:
- Once the application is created, go to the "Settings" tab of the application.
- In the "Application type" section, for the parameter "Access", check "Read and write."
- Click on "Update this Twitter application's settings" to confirm.
- Cliquez on the "Details" tab.
- Click on "Create my access token". If this is already done, then click on \"Recreate my access token\"
Warning! This will change the keys "Access token". If you have already entered them earlier in npds_twi, you must have to re-enter.
3. Grab your keys and tokens (required for setting up your module).
4. You now have the elements necessary for the operation of the bridge:
- Your Consumer key (Consumer key)
- Your consumer secret (Consumer Secret)
- Your token for Open Authentication (Access token)
- Your secret token for Open Authentication (Access token secret)
5. Continue the semiautomatic installation of the bridge.
6. Once installation is complete, go to the NPDS preferences, check in the Social Networks settings that twitter is enabled.
notes:
If you want to use npds_twi on several NPDS sites, but with a single twitter account, you should create a twitter application
for each NPDS site. This will allow you to properly inform the callback url and WebSite url each time.