Question Mise en place de Kunena

Je viens de migrer mon forum (fireboard 1.0.4 vers Kunena 1.0. et je vous fait donc profiter de toutes les étapes que j'ai suivies pour remettre celui-ci d'aplomb sous Kunena.

C'est essentiellement des choses que j'ai pu glaner ici et la ("ici" étant kunena.aide-joomla.com et "la étant le forum kunena officiel ).

J'ai rédigé cette documentation de manière à ce que chacun puisse aussi bien suivre toute la procédure de bout en bout que d'y piocher ce qui l'intéresse sur une problématique ciblée (ex : migration de forum utilisant sh404sef).

En espérant que cela aide !

Plan du tutoriel

Etape 0 - Comment utiliser ce tutoriel
Etape 1 - Migration de Fireboard 1.0.4 vers fireboard 1.0.5 RC1
Etape 2 - Migration de Fireboard 1.0.5 RC1 vers Kunena 1.0.8
Etape 3 - Installation du patch Fr
Etape 4 - Réécriture d'URL avec sh404sef
Etape 4 bis - sh404sef : Migration de la réécriture d'URL de fireboard vers Kunena
Etape 5 - Etendre la recherche joomla avec kunena_searchbot

Etape 0 - Comment utiliser ce tutoriel

Quel que soit votre but, faites tout d'abord une sauvegarde complète des fichiers sources et de la base de données de votre site !
N'effecutez pas non plus ces modifications directement sur votre site en production

Ceci étant dit, entrons dans le vif du sujet !

Vous souhaitez migrer de fireboard vers Kunena ?

- Si vous êtes sous fireboard 1.0.4 : commencez par l'étape 1
- Si vous êtes sous fireboard 1.0.5 RC1 ou RC2 : commencez par l'étape 2

Vous souhaitez simplement installer Kunena ?

- L'installation n'est pas détaillée dans ce tutoriel (dans l'étape 2 on précise simplement qu'il faut télécharger et installer kunena). Les étapes 3 et 4 peuvent cependant vous intéresser selon ce que vous souhaitez mettre en place : traductions et/ou réécriture d'url

Vous souhaitez uniquement traduire Kunena ?

- Commencez directement à l'étape 3

Vous souhaitez mettre en place de la réécriture d'url ou migrer celle de votre bon vieux forum fireboard avec sh404sef ?

- Vous trouverez votre bonheur en allant directement à l'étape 4


Etape 1 - Migration vers Fireboard 1.0.5 RC1

1. Téléchargez Fireboard 1.0.5 RC1 et fb_converter ici : kunena.aide-joomla.com/telechargement.html?func=select&id=8
2. Installez le composant fb_converter via l'assistant d'installation de Joomla (lors de l'installation, le composant prépare les données fireboard 1.0.4 pour migrer sous fireboard 1.0.5 )
3. Désinstallez le composant fireboard 1.0.4
4. Installez le composant fireboard 1.0.5 RC1
5. Désinstallez le composant fb_converter


Etape 2 - Migration de Fireboard 1.0.5 RC1 vers Kunena 1.0.8


1. Téléchargez le composant Kunena 1.0.8 disponible ici : joomlacode.org/gf/project/kunena/frs/
2. Désinstallez tous les liens qui pointent sur le composant fireboard
3. Désinstallez tous les modules, plugins et autres bots relatifs à fireboard
3. Désinstallez fireboard 1.0.5
4. Installez Kunena 1.0.8
5. Accédez à l'interface d'administration (en anglais) du forum et paramêtrez votre forum comme bon vous semble
6. Si vous faites une migration depuis fireboard, cliquez sur "recompter les stats des catégories" (Recount category stats) depuis le panneau de contrôle du forum
7. Recréez tous les liens qui pointaient sur l'ancien forum pour qu'ils pointent désormais sur le forum sous Kunena et réinstallez les plugins/modules/bots (attention à vous assurer que la version que vous installez est compatible Kunena)


Etape 3 - Installation du patch Fr

1. Téléchargez la dernière version du patch Français en date (pour la trouver, voir sur les forums kunena : ici et ici )
2. Installez le patch conformément au fichier lisez-moi.txt inclu dans le patch téléchargé (généralement un simple copier-coller des fichiers à la racine de votre site Joomla)


Etape 4 - Réécriture d'URL avec sh404sef

Si vous avez déjà sh404sef sous fireboard et que vous souhaitez migrer votre réécriture d'Url avec Kunena, l'étape 4 bis est faite pour vous ! Ignorez ce qui suit.
Si vous souhaitez installer sh404sef pour votre tout nouveau forum, suivez les instructions suivantes :

1. Téléchargez la dernière version du composant sh404sef disponible sur joomlacode (a ce jour la beta build_222 pour joomla 1.5.x)
2. Installez le composant fraichement téléchargé
3. Téléchargez le plugin kunena pour sh404sef disponible dans la section "third party" sur le svn de kunena
4. Ajoutez maintenant ce plugin dans sh404sef. Pour cela, copiez le fichier com_kunena.php contenu dans l'archive que vous venez de télécharger dans le répertoire [racine_de_joomla]/components/com_sh404sef/sef_ext/
5. Paramétrez sh404sef normalement depuis l'interface d'administration du composant

Etape 4 bis - Migration de la réécriture d'URL de fireboard vers sh404sef

1. Téléchargez la dernière version du composant sh404sef disponible sur joomlacode (a ce jour la beta build_222 pour joomla 1.5.x)
2. Désinstallez votre composant sh404sef actuel
3. Installez la nouvelle version du composant téléchargée (point 1)
4. Réalisez votre script de migration d'urls

Désormais les urls brutes ne sont plus liées au composant fireboard mais à Kunena. Les urls anciennement en com_kunena doivent donc devenir com_kunena. Le script sql de migration de la base de données comportera tout d'abord cette ligne :

Ensuite, comme nous avons modifié le menu via lequel le forum est accessible, les anciennes urls réécrites stockées dans la base de données sont aussi obsolètes sur ce point puisqu'elles contiennent l'id de l'ancien menu. Le lien avec le menu se fait via le paramètre itemid de l'url.

Dans mon cas, le nouveau menu a désormais l'id 100009 (itemid=100009 dans les urls) contre l'id 4 auparavant. Pour connaître votre itemid, il suffit d'aller dans la table jos_menu pour voir l'id associé à l'entrée du menu qui pointe sur votre forum (ou de regarder la valeur du paramêtre itemid dans l'url d'un post du forum sans avoir activé la réécriture d'url).

La seconde ligne du script de migration consiste donc à remplacer l'ancien id par le nouveau :

Evidemment, remplacez la valeur 4 par la valeur de votre ancien itemid (apparait 2 fois dans la ligne de code) et la valeur 100009 par l'id de votre nouveau menu (apparait 1 fois).

Avec ces deux ligens de code, une url du type :

devient :
5. Lancez votre script de migration des urls existantes (via phpmyadmin, cliquez sur votre base de données et soit vous tappez les deux lignes de code ci-dessus dans l'onglet "SQL", soit vous importez un fichier texte dans lequel vous avez écrit ces deux lignes).

Etape 5 - Etendre la recherche joomla avec kunena_searchbot

Le plugin kunena_searchbot permet d'étendre la recherche joomla native pour afficher aussi des résultats de recherche issus du forum.

1. Téléchargez la dernière version du plugin kunena_searchbot. Une version est disponible sur ce topic pour le moment et devrait une fois testée être officiellement en téléchargement dans la rubrique téléchargements
2. Installez le plugin via l'assistant d'installation de plugins joomla
Activez le plugin dans le gestionnaire de plugins de joomla

Bonjour,

merci pour cette contribution,, très bon tutoriel.

Modification du lien pour le téléchargement du plugin kunena à ajouter à sh404sef, qui pointe désormais sur le svn de kunena sur joomlacode, dans la partie appropriée.

Mise à jour de la partie réécriture d'url du tutorial :

- Détail de la procédure de migration de la réécriture d'Url d'un forum fireboard+sh404sef vers un forum kunenash404sef
- Séparation des étapes installation de base et migration depuis fireboard concernant la réécriture d'Url avec sh404sef