Installer T3kit pour TYPO3 9 LTS

Afin de pouvoir tester le très bon package T3KIT pour TYPO3. Nous avions réalisé en 2018 un podcast audio et vidéo sur l’installation de T3KIT avec un serveur local bitnami,

Vos retours ont étés souvent autour du même thème: Comment installer T3KIT sur mon serveur web, avec TYPO3 9 LTS?

Plusieurs raisons sont en fait à la source de vos difficultés:

Je ne trouve pas de version de T3KIT pour TYPO3 9.x ?

C’est volontaire de la part des créateurs de l’extension, en effet, T3KIT pour TYPO3 10 est en développement depuis plus d’un an et il était préférable de ne pas ressortir une version majeure de T3kit pour TYPO3 version 09.

La version de T3KIT pour TYPO3 9.x s’appelle donc T3KIT 8.9

La version disponible sur le TER ne fonctionne que pour TYPO3 6.2 LTS et 7 LTS

Le soucis vient des dépendances de T3KIT, le TER fournit une solution « clé en main » qui auto-installe les extensions dépendantes, pas de chances, la version 8 de T3KIT (pour TYPO3 8 et 9) requiert des versions d’extensions qui n’ont pas été « sorties » sur le TER.

Les extensions réputées pour poser des soucis sont principalement « gridelements » et « themes » ( beaucoup plus « themes » d’ailleurs)

'depends' => array(
             'typo3'  => '9.5.0-9.5.99',
             'gridelements' => '9.2.1-9.2.99',
             'dyncss_less' => '0.8.0-0.8.99',
             'themes' => '8.7.6-8.7.99',
             'news' => '7.1.0-7.9.99',
             'frontend_editing' => '1.4.6-1.9.99'

Extrait du fichier "ext_emconf.php" de l'extension "theme_t3kit"

Si vous savez installer T3KIT avec composer et GIT

Vous êtes fortiches avec la ligne de commande, dans ce cas pas de soucis, rendez-vous sur le site officiel, un starter kit existe et permet d’initialiser un site T3KIT avec une base peuplée.

  1. Starter Kit: https://github.com/t3kit/t3kit
  2. La base: https://github.com/t3kit/t3kit_db

Procédure d’utilisation du package manuel T3KIT

Vous en avez rêvé ? Voici la version pour les mauvais, pour les vilains, les dissidents, ceux qui ont un hébergement moisi, sans ligne de commandes, ceux qui n’ont pas la possibilité de modifier les droits sur les fichiers, d’utiliser composer ou docker, ceux qui, cachés dans l’ombre songeaient à installer wordpress !

STOP, voici la procédure pour installer T3KIT avec TYPO3 9, et afficher rapidement un site avec tous les contenus de démo du package.

Pour installer ce package, vous aurez besoin d’un compte ftp, d’un accès à « phpmyadmin » ou « adminer » et si possible d’un outil de gestion de fichiers permettant de décompresser des archives. (sinon il faudra tout uploader et c’est plus long)

1. Télécharger tous les fichiers

  • init_t3kst1_sql.zip : La base de données SQL avec les contenus d’exemples du package T3KIT
  • init_t3kst1.fileadmin.zip : Le dossier fileadmin avec les médias d’illustration du package
  • init_typo3conf_ext.zip : Le dossier typo3conf/ext/ avec les extensions et dépendences
  • init_t3kst1.rootfiles.zip : Les fichiers à mettre à la racine (les favicons et autres trucs divers)

2. Créer une base de données et la peupler avec le fichier .sql du package

2.1 Procédures annexes non obligatoires – au cas où –

Convertir l’interclassement en UTF-8 si nécessaire

ALTER DATABASE NOMDELABASEICI CHARACTER SET utf8 COLLATE utf8_general_ci

En gras ce qui peut / doit être modifié. Le nom de la base (obligatoire) et l’encodage, à vous de voir si vous voulez utiliser « utf8mb4_unicode_ci »

Au cas où vous en auriez besoin plus tard, voici la commande pour convertir l’interclassement des tables, en deux étapes (de rien)

  1. On génère une liste de commandes qui va nous permettre d’automatiser la conversion pour toutes les tables
  2. On exécute la commande fournie par phpmyadmin
SELECT CONCAT('ALTER TABLE ', tbl.TABLE_SCHEMA, '.', tbl.TABLE_NAME, ' CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;') FROM information_schema.TABLES tbl WHERE tbl.TABLE_SCHEMA = 'NOMDELABASEICI'

La requête précédente va créer toutes les requêtes vous permettant de transformer chaque table une par une, d’un seul coup, plutôt que le le faire à la main pour chaque table avec une commande comme celle ci:

ALTER TABLE NOMDELABASEICI.be_groups CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;    

Attention, la requête est assez grosse, autant que le nombre de tables, et pour la récupérer dans « phpmyadmin » il faut:

  1. cocher la case « Option>Textes complets »
  2. récupérer la requête dans le presse papier
  3. exécuter le contenu du presse papier dans le champ « SQL » de phpmyadmin

2.2 Import du fichier SQL fournis dans le package

Ensuite, nous allons importer le fichier de base de donnée via un outil comme « phpmyadmin » ou « adminer« .
Ces outils sont souvent disponibles sur les hébergements mutualisés type plesk ou Cpanel.

Si vous débutez, il est plus facile d’installer « adminer » que « phpmyadmin », 1 seul fichier à déposer sur votre serveur.

Utilisez simplement la fonction importer de votre outil de gestion de bases de données.

Vous avez maintenant une base TYPO3 complète, qui contient toutes les données nécessaires ainsi qu’un utilisateur admin/admin1234

3. Installer TYPO3 9 LTS avec notre BDD

Ici, à vous de jouer, installez TYPO3 9 LTS selon la procédure qui vous convient le mieux, en utilisant l’install 123 ou tout autre procédé.

Fin de l'installation de TYPO3

Nous allons, après le processus d’installation, connecter notre installation à la base créée à l’étape 02 ou alors écraser la base initialisée par TYPO3 par notre fichier . sql en reproduisant l’étape 02.

Deux possibilités:

  • J’écrase ma base TYPO3 via phpmyadmin/adminer après avoir installé TYPO3
  • Je connecte TYPO3 à ma base existante et peuplée pendant l’installation

4. Uploadez les extensions dans le dossier typo3conf/ext.

Maintenant au tours du fichier « init_typo3conf_ext.zip » à uploader dans le dossier typo3conf/ext/

typo3conf/ext/
Décompressez les extensions dans le dossier typo3conf/ext/ puis supprimez le fichier zip

5. Installer « theme_t3kit » et ses dépendances

Nous allons maintenant activer les extensions qui nous intéressent d’un seul coup en installant celle qui contient toutes les dépendances: [theme_t3kit]

forcer les dépendances
On « know what we are doing » et on installe en forçant les dépendances

Les extensions que vous avez uploadé dans le dossier typo3conf/ext vont s’installer automatiquement si vous installez theme_t3kit en acceptant de forcer l’installation.

6. Ecraser notre dossier « fileadmin »

Uploadez le contenu du fichier « init_t3kst1.fileadmin.zip » soit en remplaçant le dossier existant soit en uploadant le contenu dans votre dossier. Ce dossier contient les médias (images et vidéos ») des contenus du package de démo de T3KIT.

Le plus simple reste de supprimer le dossier existant et de dé-zipper le nouveau à la racine.

7. Uploadez les icones et fichiers à la racine de votre site

Vous pouvez dé zipper le contenu du fichier « init_t3kst1.rootfiles.zip » à la racine du dossier de votre site.

8. Et voilà tadaaaa

F.A.Q.

  • Quel est le compte admin pré-configuré dans la base? admin/admin1234
  • Est-ce qu’il y a un domaine pré-configuré ?
    Non, à toi de créer la configuration dans le menu « Sites management > Sites »
  • Pourquoi d’autres extensions sont présentes dans le dossier typo3conf/ext/
    ce sont des extensions que j’utilise souvent, cadeau à toi de tester !

Intégrateur TYPO3 depuis 2003, maintenant responsable du pôle d'expertise chez TalanSolutions. Je réalise des audits, des préconisations, des missions d'expertise. J'ai la chance de diriger le plateau technique Web PHP / TYPO3 d'EXL Group.

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.