DOCUMENTATION : Créer une extension simple pour phpBB 3.1.x, 3.2.x & 3.3.x

[Raphaël]

Salut,

une documentation à propos de la création des extensions a été créée par memberlist.php?mode=viewprofile&u=148.

Consulter : [phpBB 3.1.x] Créer une extension simple.

Bonne lecture !

D’autres ressources sont communiquées sur les pages de ce sujet, aussi je vous invite à prêter attention aux messages suivants.

[BryanD]

Hello,
Merci à lui, car sans lui et sa traduction en français on serait perdu
BryanD

[Dakin Quelia]

Ce n'est pas une traduction. C'est carrément un truc personnalisé.

[FranckTH]

Bonjour,

Je ne sais pas si je suis au bon endroit mais j'aimerais quelques renseignements sur la façon dont est créé une extension et tout particulièrement le mien

https://www.phpbb.com/customise/db/mod/ ... _column_2/

Ce Mod ne modifie que le CSS et le HTML mais j'ai bien pigé le principe des extensions et surtout la façon dont sont gérés les modifications

Message modifié par : « Raphaël ».
Raison : Ajout d’une icône de sujet et modification mineure du sujet.

[Raphaël]

Salut,

en premier lieu, ton MOD est original, oui ce sera un bon exercice pour apprendre.

De mon côté je t’invite à lire cette page, la partie « For Developers ».

Une fois ceci fait, tu as un guide disponible sur cette page et sur celle-ci.

Pour tout ce qui touche à la réalisation d’extension tu devrais consulter ce forum.

Lorsque tu seras prêt à passer à l’action, il y a un sujet mentionnant tous les outils mis à disposition.

Tu peux télécharger l’extension de démonstration proposée par phpBB.com.

Voilà en somme tout ce que je sais, tu as du voir le sujet dans ce forum qui explique « Comment créer un extension », je l’ai mis en post-it avec un intitulé « Documentation ». Tu peux aussi le consulter.

Je ne suis pas codeur, aussi je te souhaite bonne continuation !

EDIT : ne pas oublier phpbb-fr.com qui peut aussi t’aiguiller.

[Raphaël]

Pas contre je me rends compte que je n’ai pas répondu exactement à ta question, alors je ne suis pas codeur mais je comprends certaines choses.

Partant du principe que depuis phpBB 3.1.x on ne peut plus éditer les fichiers PHP/HTML de phpBB pour les extensions, le système d’évènements (phpBB events) a été mis en place dans le code de phpBB 3.1.x.

Ces évènements comme par exemple celle-ci : <!-- EVENT nom_du_fichier_endroit_dans_le_fichier --> sont en somme des balises, qui permettent aux extensions d’insérer du code à certains endroits des fichiers. C’est comme des portes d’entrée pour dire : « Coucou ici tu peux insérer du code », alors qu’aux endroits ou il n’y a pas de balise ton extension ne sera pas en mesure d’insérer du code.

Il y a des évènements du template (pour les fichiers HTML du style) et des évènements du core (pour les fichier PHP principalement).

Entre chaque mise à jour de phpBB, les auteurs d’extensions soumettent des demandes d’évènements pour que lors d’une nouvelle version de phpBB ils puissent s’en servir afin de faire fonctionner leur extension.

Donc tu devrais jeter un œil aussi aux « template events » existants pour voir si ton MOD serait compatible avec phpBB 3.1.4 ou si il te faut demander la création de nouveaux évènements à des endroits bien précis du code des fichiers du style.

[FranckTH]

Bien vu Raphaël, je viens donc de me rendre compte que là ou je dois apporter la modification html je n'ai pas d'event... je trouve assez étrange du coup que chaque codeur qui créé une extension soit obligé de demander à phpbb.com l'ajout d'events et donc de mettre à jour la version de phpbb

[Raphaël]

Dès lors que la version 3.1.x de phpBB a été publiée en octobre 2014 ce système s’est mis en place au fur et à mesure des mises à jour.

Tu verras que dans un an, plus aucun codeur d’extension ne fera de demande d’évènements à phpBB.com.

Par ailleurs, ça évite à l’équipe des développeurs de phpBB de chercher les endroits où il est intéressant de placer une balise « event ».

Au moins avec ce système de demande, tout évènement créé est assuré d’être utilisé, ce qui allège le code des fichiers.

[Raphaël]

Pour soumettre des évènements cela se passe sur cette page : https://tracker.phpbb.com/secure/Dashboard.jspa.

[FranckTH]

Certes, mais donc pour le moment c'est assez restrictif car j'imagine que le temps que les développeurs de phpbb ajoutent les events en fonction de leur utilité ou non, il peut se passer un certain temps, voir même l'impossibilité de convertir un ancien Mod s'ils jugent qu'il n'est pas utile...

[Raphaël]

Non franchement, je n’ai pas vu de demandes d’évènements refusées pour cette raison-ci. Si la demande est refusée, elle est justifiée et réorientée vers une autre solution, tu peux donc y aller gaiement.

[Dakin Quelia]

En effet, j'ai publié une demande pour ajouter un évènement dans le fichier template de la vue des forums et ça n'a pas été refusé et déjà mis en place pour la 3.1.5. Je n'ai pas vu, non plus, de refus d'ajouter des évènements.

[Raphaël]

Un article du blog de phpBB.com nous informe qu’un outil a été développé pour aider les auteurs d’extensions, voir cette page : https://blog.phpbb.com/2016/03/29/exten ... ment-tool/. Ce outil a été traduit il est disponible depuis le viewtopic.php?f=11&t=762.

Le dépôt des fichiers de cet outil se trouve ici : https://github.com/phpbb-extensions/phpbb-ext-skeleton.

[Raphaël]

Voici les documentations officielles sur :

• la création d’une extension pour phpBB 3.1.x : https://area51.phpbb.com/docs/dev/3.1.x ... index.html
• le fonctionnement de phpBB Skeleton Extension : https://area51.phpbb.com/docs/dev/3.1.x ... nsion.html ;
• comment transformer un MOD pour phpBB 3.0.x en une extension pour phpBB 3.1.x : https://area51.phpbb.com/docs/dev/3.1.x ... nsion.html.

[Raphaël]

À noter que l'outil présenté sur le viewtopic.php?f=11&t=168 propose des outils pour créer son extension.