[phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Support pour n'importe quelle extension non présente dans notre base de données
Aucune demande de personnalisation des extensions n'est autorisée.

Modérateur: Equipe

Règles du forum
A lire impérativement : Règlement de phpBB-fr.com - Conditions générales de support des extensions de phpBB-fr.com

Merci de mettre le nom de l'extension ainsi que sa version entre crochets, et un titre explicite afin de faciliter la recherche.
Exemple : [nom de l'extension + numéro de version] Titre explicite résumant le problème

Le lien de téléchargement de l'extension est demandé pour toute demande de support.

Aucune demande de personnalisation des extensions n'est autorisée.

[phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar FoFa » 16 Mai 2016 à 00:11

Hello,

Il s'agit d'un outil officiel en cours de développement par le groupe phpBB.

Article sur le blog phpBB => https://blog.phpbb.com/2016/03/29/exten ... ment-tool/
Page github => https://github.com/phpbb-extensions/phpbb-ext-skeleton
Page d'essai de l'extension => http://www.forumsfaciles.fr/skeleton

J'ai voulu donc tester, cela fonctionne à merveille. Néanmoins, je ne comprends pas quelques options que je peux cocher et je ne souhaite pas cocher des options qui ne me serviront pas.

Quelqu'un peut-il éclairer ma lanterne s'il vous plaît ? En utilisant cet outil, j'ai chargé un "squelette d'extension" et j'ai même réussi à "modifier" la page posting.php via l'utilisation d'un event :wink:

  1. Première colonne
    1. PHP listeners
      • Aucune idée
    2. Administration control panel (ACP)
      • Je pense qu'il s'agit là d'un moyen pour ajouter quelque chose dans le PCA (configuration et tout le tralala de l'extension)
    3. User control panel (UCP)
      • Pareil, pour permettre à l'utilisateur de configurer certains paramètres de l'extension via son PCU
    4. Service
      • Aucune idée
    5. Extension base (ext.php)
      • Aucune idée
    6. Cron task
      • Permettre la mise en place de tâches exécutables sans mon intervention
    7. PHPUnit tests
      • Aucune idée
    8. Build script (phing)
      • Aucune idée
  2. Seconde colonne
    1. Styles listeners
      • Aucune idée
    2. Moderator control panel (MCP)
      • Ajout de fonctionnalités dans le PCM
    3. Database migration
      • Pour gérer les mises à jour de l'extension ?
    4. Controller (front page)
      • Aucune idée
    5. Console command
      • Aucune idée
    6. Notifications
      • Si mon extension doit envoyer des notifications à l'utilisateur, c'est ici que cela se passera
    7. Test execution on Travis-CI
      • Aucune idée

Je vous remercie de votre aide ^_^
De retour parmi vous :wink:
FoFa
Resp. des supporters
Resp. des supporters
 
Messages: 10592
Enregistré le: 15 Nov 2008 à 18:04
Localisation: Auxonne

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar FoFa » 20 Mai 2016 à 21:30

Petit up du soir, bonsoir :wink:
De retour parmi vous :wink:
FoFa
Resp. des supporters
Resp. des supporters
 
Messages: 10592
Enregistré le: 15 Nov 2008 à 18:04
Localisation: Auxonne

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar Skouat » 21 Mai 2016 à 11:01

Salut,

Tout d'abord je tiens à préciser que je risque de dire pas mal d'inexactitude.
Je vais tenter d'expliquer selon ma compression et non apporter des réponses exactes.
Toutefois, je pense que globalement mes réponses ne seront pas trop erronées.
____________________________

Globalement Skeleton est un assistant pour t'aider à démarrer une extension sans trop te poser de question sur comment nommer un fichier et où le placer. L'idée est très bonne, mais peut vite embrouiller les esprits.
Si tu veux avoir une meilleure idée de qui fait quoi, le mieux c'est déjà de prendre chaque élément à cocher de manière indépendante et de voir où cela peut agir au niveau du forum. Car si tu sélectionnes tout tu pourrais vite ne plus savoir qui fait quoi.

FoFa a écrit:PHP listeners

=> en équivalence MOD, le listener est là pour se substituer à toute portion de code que tu devais ajouter dans les fichiers de base de phpBB. En gros toutes les instructions que tu mettais dans le fichier MODs install.xml (ajout des clés de langues, ajout de liens dans le header, ajout de template personnalisés, ajout de permissions, etc.).
=> Ces fichiers se situent dans le répertoire events. Il sont lus/chargés dès que tu accèdes au forum.
=> c'est là que tu déclares les events qui vont interagir avec phpBB
Exemple:
Code: Tout sélectionner
        return array(
            'core.index_modify_page_title'       => 'load_index_data',
            'core.page_header'                   => 'add_page_header_link',
            'core.permissions'                   => 'add_permissions',
            'core.user_setup'                    => 'load_language_on_setup',
            'core.viewonline_overwrite_location' => 'viewonline_page',
        ); 


FoFa a écrit:Administration control panel (ACP) et User control panel (UCP)

C'est bien ce que tu penses.
En équivalence MOD il s'agit des fichiers que tu plaçais dans /includes/acp ou /includes/ucp, mais aussi des fichiers de langue nommés info_acp_... ou info_ucp_..., etc.

FoFa a écrit:Service

Ce fichier permet, entre autre, de charger les classes d'objets que tu vas déclarer dans les "contructeurs".
Je ne m'étale pas sur ce sujet car je risque de dire des inexactitudes.

FoFa a écrit:Extension base (ext.php)

Tout est dit dans la note présente dans ce fichier.
* NOTE TO EXTENSION DEVELOPERS:
* Normally it is not necessary to define any functions inside the ext class below.
* The ext class may contain special (un)installation commands in the methods
* enable_step(), disable_step() and purge_step(). As it is, these methods are defined
* in phpbb_extension_base, which this class extends, but you can overwrite them to
* give special instructions for those cases.

En gros, ce fichier permet d'effectuer des instructions lors de l'activation, la désactivation ou la purge de l'extension.
Par exemple, si des extensions utilisent le système de "Notifications", il faut agir au niveau de phpBB pour initier ou purger les notifications générer par ton extension.
FoFa a écrit:Cron task

Un exemple de tâche serait la purge des sujets délestés.
FoFa a écrit:PHPUnit tests

rahhh... encore quelque chose que je ne sais pas dompter.
Les PHPUnit tests permettent de mettre en place des points de contrôle qui, lors de la modification de ton code, vont contrôler que la modification de ce dernier ne va nuire à son bon fonctionnement.

fin des explications... il faut que je file.

++
Skouat
Traducteur
Traducteur
 
Messages: 13844
Enregistré le: 02 Avr 2008 à 19:47

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar FoFa » 21 Mai 2016 à 20:58

Hello,

Merci pour ces quelques éclaircissements. Vais continuer à prospecter et si besoin à faire tout à la main comme j'ai fait jusqu'à maintenant :lol:

Si quelqu'un veut continuer/approfondir la question, ce sera avec plaisir que je le lirai :mrgreen:
De retour parmi vous :wink:
FoFa
Resp. des supporters
Resp. des supporters
 
Messages: 10592
Enregistré le: 15 Nov 2008 à 18:04
Localisation: Auxonne

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar pierredu » 22 Mai 2016 à 08:22

Sur le fichier services.yml (dossier config) :

C'est là que l'on déclare les variables qui seront envoyées au constructeur de la classe. On peut donc avoir un élément pour chacune des classes créées dans l'extension (par exemple le listener dans le dossier event, mais aussi d'autres, placées par exemple dans un dossier core).

Pour une extension simple, on a seulement un services.yml, mais on peut aussi en avoir d'autres, comme routing.yml et tables.yml. Regarde mon extension glossaire pour des exemples.

En fait, pratiquement, pour tout ça, on travaille par copier-coller, parce que, généralement, on ne part pas de zéro, mais d'une extension préexistante qui se rapproche au plus de ce que l'on fait. Moi, je suis parti de l'extension demo/acme. Mais j'ai un peu galéré pour arriver à comprendre et à avoir quelque chose qui tourne.

Encore une chose : à partir de 3.2.x, il faut avoir les guillemets simples.
Avatar de l’utilisateur
pierredu
Resp. Extensions
Resp. Extensions
 
Messages: 1112
Enregistré le: 29 Mai 2011 à 05:49
Localisation: Paris

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar FoFa » 22 Mai 2016 à 08:43

Oui mais bon l'extension acme j'ai pas accroché mais oui je partirai de là si besoin.

Merci pour ta participation @pierredu
De retour parmi vous :wink:
FoFa
Resp. des supporters
Resp. des supporters
 
Messages: 10592
Enregistré le: 15 Nov 2008 à 18:04
Localisation: Auxonne

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar Skouat » 24 Mai 2016 à 06:49

Hello !

Encore en mode je n'ai pas trop le temps...

FoFa a écrit:Moderator control panel (MCP)

C'est bien ce que tu penses. Donc pareil que ACP et UCP.
FoFa a écrit:Database migration

on ne parle plus trop de mises à jour de l'extension, bien que pour simplifier les choses c'est ce qu'on continue de faire.
Il s'agit du répertoire de stockage de tous les fichiers qui sont susceptibles d'apporter une modification tant au niveau de la structure que du contenu de la BDD.
C'est une grosse évolution de « UMIL ».
FoFa a écrit:Notifications

C'est bien pour les notifications.
FoFa a écrit:Console command

Depuis 3.1, il a été introduit la possibilité d'effectuer des actions en ligne de commande.
ex php.exe /bin/phpbbcli cache:purge va purger le cache du forum.

Allez hop ! je file ;)
++
Skouat
Traducteur
Traducteur
 
Messages: 13844
Enregistré le: 02 Avr 2008 à 19:47

Re: [phpBB Ext Skeleton - 1.0.0-B1] Signification des options à cocher

Messagepar Skouat » 28 Mai 2016 à 18:07

Build Script

Il s'agit du fichier build.xml présent dans l'archive généré par Skeleton.
Ce fichier permet de nettoyer le .zip qui sera généré via Github.

Test execution on Travis-CI

Permet de lié ton dépot à la plateforme de test d'intégration continue Travis.
N'est utile que si tu as ton dépot sur Github ou toute autre plateforme Git autorisant l'utilisation de Travis CI.
L'utilité de Travis CI, c'est d'analyser ton code afin de débusquer des erreurs de code, basée sur les directives de dev de phpBB, ou encore de vérifier que ton code est compatible avec les différentes versions de PHP ou différent type de base de données.

Controller (front page)

Je ne sais pas trop comment expliquer ce type de fichiers.
Si tu prends mon extension, tu pourras noter plusieurs controller (mais pas que cela).
J'ai déclaré un controller pour chacun des modules.
J'aurais pu créer un seul controller, mais histoire de faciliter la lecture du code et de le simplifier j'en ai créé plusieurs.

Après si l'extension est "petite", souvent tout le code va se retrouver dans le fichier acp/<extname>_module.php (ou ucp, ou mcp)

____________________________

Je pense qu'on a fait le tour de toutes les catégories.
Je laisse le soin aux autres membres de me corriger ou de préciser un peu plus mes commentaires.

++
Skouat
Traducteur
Traducteur
 
Messages: 13844
Enregistré le: 02 Avr 2008 à 19:47


Retourner vers Support des extensions non présentes dans notre base de données

 


  • Articles en relation
    Réponses
    Vues
    Dernier message

Qui est en ligne

Utilisateurs parcourant ce forum : Aucun utilisateur enregistré et 1 invité