### Administration - npds_twitter

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

1. Inscrivez vous sur twitter en tant qu'utilisateur ICI.
2. Inscrivez vous en tant que développeur ICI.

##### Créez et paramétrez l'application

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>`

npds_twitter - Manuel administration