Guide d'installation phpBB 3.1 et 3.2

Avant d’aller plus loin, assurez-vous que la version PHP de votre forum phpBB est égale ou supérieure à la version 5.6 (5.6+ ou 7.x). Si ce n’est pas le cas, faites d’abord une migration de votre version PHP vers la dernière version stable (version 7.2 recommandée) avant de continuer.

Pour commencer, il vous faudra télécharger sur votre ordinateur le plugin Topic'it pour les forums phpBB 3.1.x et 3.2.x via votre compte sur le site Topic'it :

• 1 - Dans votre espace personnel, accédez à l'onglet "Inscrire un forum".
• 2 - Cliquez sur le bouton pour télécharger le plugin pour votre forum.
• 3 - Choisissez le plugin pour plugin phpBB 3.1 et 3.2. Il s'agit du même plugin pour les deux versions.

Vous pouvez également accéder directement au plugin phpBB depuis la rubrique "Plugins phpBB" du site Topic'it.

Décompressez l’archive. Vous obtiendrez deux dossiers ("ext" et "topicit").

En utilisant votre logiciel client FTP préféré, transférez le contenu du dossier "ext" du fichier Topic’it téléchargé dans le dossier "ext" distant se trouvant à la racine de votre installation phpBB. De la même façon, transférez le dossier "topicit" du fichier Topic’it téléchargé et déposez le directement à la racine de votre installation phpBB.

Connectez-vous au panneau de contrôle d’administration de votre forum phpBB. Puis allez dans l’onglet Personnalisation >> Gestion des extensions >> Gérer les extensions >> Topic’it plugin [phpBB 3.1 et 3.2] : Cliquez sur le lien "Activer".

Puis validez l’activation du plugin.

Un message vous confirmera alors le succès de l’opération.

Félicitation, vous venez d’activer Topic’it sur votre forum.

Pour retrouver votre forum dans Topic'it :

• 1 - Lancez l'application mobile Topic'it sur Android ou iOS.
• 2 - Allez sur la vue "Découvrir" ou "Annuaire".
• 3 - Cliquez sur l'icône de recherche (en haut à droite).
• 4 - Renseignez le domaine ou l'URL du forum.

Il vous suffit ensuite de cliquer sur l'icône "Ajouter aux abonnements" pour accéder au forum en un clic et le suivre.

Dès lors, vous avez terminé l’installation de l'API Topic'it sur votre forum, il ne vous reste plus qu’à la configurer. Pour cela, vous allez devoir renseigner dans l’onglet "extensions" >> Topic'it >> Topic'it Settings de votre panneau de contrôle d’administration (cet onglet est automatiquement créé si vous n’avez pas d’autres extensions installées sur votre forum avant Topic’iT) les informations relatives à l’API Topic’it de votre forum :

Pour obtenir ces informations, rendez-vous dans votre compte Topic’it rubrique "inscrire un forum" puis dans la partie "Vérification de l'installation du plugin Topic'it", mettez l’url de votre forum dans le champ "adresse internet de votre forum" puis cliquez sur le bouton "Vérifier l’installation".

Topic’it détectera alors l’installation de son plugin sur votre forum et validera automatiquement l’étape 1 de vérification. Vous pouvez dès lors renseigner les informations relatives à votre forum (nom, description, logo, bannière, etc.). Ce sont ces informations qui apparaîtront pour lui lors d’une recherche sur l’application Topic’it par exemple.

Puis cliquez sur le bouton "Passer à l’étape 3" en bas de la page. Vous obtiendrez ainsi la clé API de votre forum.

A ce stade, il vous suffira de copier/coller votre clé API dans le champ approprié des options générales de réglage de votre extension Topic’it sur votre panneau de contrôle d’administration et d’enregistrer. Vous pouvez aussi choisir vos préférences au niveau des autres options de configuration Topic’it mais elles ne sont pas obligatoires.

Un message d’information vous annoncera dès lors la prise en compte de votre ajout :

Il ne vous manquera plus qu’à achever la vérification de l’ApiKey de votre forum en appuyant sur le bouton « Vérifier la clé API » directement dans votre interface d’administration Topic’it

Félicitation, vous venez de configurer l’API Topic’iT sur votre forum.