Base de données de personnalisation Foire aux questions (Questions posées fréquemment)

Qu’est-ce que Titania (alias la Base de données ou Base de données de personnalisation) ?

Qu’est-ce que Titania ?
Titania (alias la base de données de personnalisation) est une base de données où les utilisateurs peuvent télécharger des extensions et des styles pour un forum phpBB. Vous êtes également assuré que l’extension ou le style que vous avez téléchargé respecte les conditions de validation de phpBB.
Haut

Une validation ? Qu’est-ce ?
Toutes les extensions ou styles téléchargés par vous au sein de Titania ont été validés. La validation signifie qu’une extension, ou un style, a fait l’objet d’un examen minutieux quant à la sécurité du code en question, ainsi que des tests visant à s’assurer de la bonne installation et du bon fonctionnement de l’extension ou du style avec une version particulière d’un forum phpBB. La validation vous apporte une certaine assurance en sachant que vous n’êtes pas en train de télécharger ou d’installer une extension ou un style susceptible de rendre votre forum vulnérable.
Haut

How to use Titania

Trouver une contribution
Il existe plusieurs façons de trouver une contribution. Sur la page principale de la base de données, vous pouvez voir les catégories disponibles ainsi que les modifications et les styles récemment validés.
Haut

Trouver une extension
Vous pouvez soit accéder directement au type de modification souhaité en fonction de la catégorie sur laquelle la contribution est fondée (Outils, Communication, Sécurité, Divertissement, etc.), soit utiliser la fonction de recherche située au haut de la page. Si vous utilisez la fonction de recherche, vous pouvez utiliser des caractères génériques et effectuer une recherche sur le nom de la contribution (ou une partie de son nom) ainsi que le nom de l’auteur. Une fois que vous avez trouvé la contribution qui vous intéresse, vous serez redirigé vers la page « Détails de la contribution », où vous pourrez télécharger la version la plus récente de la contribution ainsi que les versions précédentes à partir de l’onglet « Révisions »
Haut

Trouver un style
De la même manière que pour trouver une extension, Titania vous permet également de rechercher des styles, des packs de smileys, des images de rangs ainsi que d’autres éléments. La fonction de recherche vous permet également d’utiliser des jokers ou de chercher d’après le nom des auteurs. Une fois que vous avez trouvé le type d’élément que vous recherchiez, vous serez redirigé vers la page « Détails sur la contribution », où vous trouverez le lien de téléchargement de la version la plus récente dudit élément, ainsi que les précédentes versions dans la section « Révisions ».
Haut

Support des personnalisations

Règles
Depuis l’introduction de Titania, les règles concernant son utilisation sont très simples. Par le passé, l’adage « Vous devriez demander de l’aide dans le sujet de la modification/du style où vous l’avez obtenu » persistait. Alors que l’équipe de support fait de son mieux pour vous aider dans la gestion et l’utilisation de votre forum, ils ne peuvent pas, et ne devraient pas, fournir de support pour toutes les contributions. Nous souhaitons que l’auteur de ladite contribution assure lui-même le support auprès de l’utilisateur final. Gardez à l’esprit que tous les auteurs sont des bénévoles qui ont pris sur leur temps libre pour vous fournir des améliorations au logiciel phpBB. Le dicton « On attrape plus de mouches avec du miel qu’avec du vinaigre » s’applique ici : veuillez garder cela à l’esprit quand vous demandez de l’aide pour une personnalisation (par exemple, soyez agréable lorsque vous formulez une demande).
Haut

Comment obtenir du support ?
Chaque personnalisation dispose d’une solution pour vous fournir un support. L’auteur a la possibilité de rédiger des FAQ concernant la personnalisation et dispose de son propre espace de discussion et de support. Ce support peut varier, allant jusqu’à l’assistance à l’installation. Il peut également mettre des compléments à votre disposition afin d’améliorer la personnalisation. Pour accéder à cette partie, il vous suffit de cliquer sur l’onglet « Discussions/Support » de la personnalisation concernée. Vous avez alors la possibilité de poser une question ou de laisser un commentaire à l’auteur. N’oubliez pas que l’auteur a l’amabilité de vous proposer sa contribution : comprenez qu’il n’est nullement obligé de vous fournir son support. Si vous jugez qu’un message ou qu’un commentaire n’est pas dans le meilleur intérêt de la communauté, n’hésitez pas à utiliser le bouton « Rapporter le message » pour qu’un modérateur se charge de prendre les mesures appropriées.
Haut

Créer et gérer les contributions

Créer une contribution
Comme pour toutes contributions, les auteurs sont priés de respecter certaines directives lors de la soumission de leur propre contribution. Les Directives de codage, bien qu’intimidantes au début, sont en fait vos amies. Elles doivent être respectées au mieux, afin que votre contribution soit diffusée au sein de la communauté. Dans le cas d’une extension, le pré-validateur d’extension pour phpBB (plus connu sous l’abréviation « EPV ») sera exécuté lors de chaque soumission d’une révision et vérifiera certains détails importants tels que le type de licence, la version de phpBB utilisée et les exigences de versions et d’empaquetage.
Haut

Soumettre une contribution
Ainsi, vous avez créé une contribution. Faisons en sorte de la publier !

Pour soumettre une contribution, vous devez vous rendre dans la base de données : sur cette page, vous trouverez un bouton intitulé « Nouvelle contribution ». Une fois que vous aurez cliqué dessus, vous pourrez saisir le nom de votre contribution, sélectionner son type, ajouter une description (les smileys et le BBCode sont autorisés), sélectionner la ou les catégories adéquates, d’ajouter des coauteurs éventuels ainsi que des captures d’écran. Veuillez garder à l’esprit que, lorsque vous soumettez la contribution, celle-ci sera assignée à votre nom.
Haut

Gérer les contributions
Sitôt votre contribution transférée dans Titania, vous avez la possibilité de la gérer. Après l’avoir sélectionnée en cliquant sur le lien « Mes contributions » en haut de la page, vous pouvez y ajouter des informations supplémentaires via l’onglet « Gérer la contribution ». Vous pouvez modifier la description de la contribution, transférer des captures d’écran, changer la propriété de la contribution (cette opération est irréversible, afin de s’assurer que vous souhaitez vraiment attribuer les droits de votre contribution à un autre utilisateur), modifier les catégories auxquelles elle est susceptible d’appartenir, ainsi que fournir, à l’attention des utilisateurs, un lien vers un forum de démonstration afin qu’ils puissent constater visuellement à quoi ressemble la contribution et comment elle fonctionne.
Haut

Soumettre une nouvelle révision
Vous pouvez transférer des nouvelles révisions depuis la page principale, onglet « Détails de la contribution », de votre personnalisation. Dès que vous cliquez sur le lien « Nouvelle révision », une page s’affiche, depuis laquelle vous pourrez transférer la révision, lui assigner une version et adresser des informations complémentaires à l’attention de l’équipe de validation (le BBCode et les smileys sont autorisés). Vous pouvez également choisir que l’équipe de validation « réempaquette » l’extension. Le réempaquetage consiste à apporter des corrections mineures à votre personnalisation. Cette opération peut impliquer des corrections sur le fichier composer.json voire des changements mineurs de code. Le réempaquetage ne consiste pas à ce que l’équipe de validation réécrive des parties majeures du code que vous avez fourni. Ça, c’est votre « travail ».

Les règles qui s’appliquent à la création d’une personnalisation sont également valables lorsque vous la soumettez à la validation. De même, le pré-validateur d’extension pour phpBB (plus connu sous l’abréviation « EPV ») sera exécuté lors de la soumission de votre personnalisation et vérifiera certains détails importants tels que le type de licence, la version de phpBB utilisée et les exigences de versions et d’empaquetage.
Haut

Fournir du support

FAQ
Chaque personnalisation permet à l’auteur de créer des sujets de type FAQ. Ces derniers doivent être rédigés de façon à ce que l’utilisateur puisse les comprendre et les appliquer à la personnalisation, de même que le sujet concernant l’installation de la personnalisation, l’accès à ses fonctionnalités, etc. Sachez que cette partie vous est destinée. Les utilisateurs ne peuvent ni modifier, ni répondre aux FAQ.
Haut

Forum de support
N’oubliez pas que les utilisateurs pourront poser des questions ou publier des commentaires sur votre contribution. Nous vous demandons d’assurer le support de votre contribution autant que vous le pourrez. Nous sommes conscients que vous avez pris sur votre temps libre pour créer votre contribution et que la vie de tous les jours peut, parfois, être bien plus agréable. Nous vous demandons simplement à vous, auteur(s), d’assurer le support autant que possible. Si vous jugez qu’un message ou qu’un commentaire n’est pas dans le meilleur intérêt de la communauté, n’hésitez pas à utiliser le bouton « Rapporter le message » pour qu’un modérateur se charge de prendre les mesures appropriées.
Haut

Validation

Ma contribution ne passe pas la pré-validation
Pour mémoire, chaque personnalisation se doit d’utiliser le bon type de licence (actuellement la GNU GPL dans sa version 2), la bonne version du logiciel phpBB et doit être correctement empaquetée. Votre personnalisation ne pourra pas être acceptée dans la base de données si elle ne respecte pas ces éléments fondamentaux. Certaines erreurs sont simplement des avertissements et ne nécessitent pas forcément de correction. Si vous n’êtes pas certain du problème, n’hésitez pas à continuer le processus de soumission et un validateur s’en chargera.
Haut

Ma contribution a passé la pré-validation, et maintenant ?
Dès lors qu’une personnalisation est proposée pour la base de données, votre demande est transmise à l’équipe compétente, qui se chargera de contrôler votre contribution. Il se peut que vous receviez un message indiquant que votre personnalisation a été refusée. Ne vous inquiétez pas : il se peut que vous ayez négligé certaines parties ou que des éléments soient manquants. Ne vous tracassez pas pour autant. Le message que vous recevrez mentionnera des éléments que nous avons décelés. Ces derniers peuvent nécessiter des changements dans le code ou sur des images, et éventuellement sur la « convivialité ». D’un point de vue général, les suggestions concernant la « convivialité » ne sont que… des suggestions. La partie la plus importante de toute personnalisation est la sécurité, et non son aspect pour l’utilisateur final.

Si aucun élément troublant n’a été décelé lors de la validation de votre contribution, vous recevrez un message privé indiquant que votre contribution a été acceptée dans la base de données. Il est maintenant temps de vous détendre un peu et de vous réjouir de la contribution que vous avez apportée à la communauté du logiciel libre.

Peu importe le résultat de la validation, sachez que nous apprécions le temps et l’effort que vous avez consacrés à l’élaboration de votre contribution.
Haut

Qui validera mes contributions ?
S’il s’agit d’une extension, elle est validée par l’équipe des extensions, celle des validateurs juniors des extensions et, parfois, par un membre de l’équipe de développement. Un style est validé par l’équipe des styles et celle des validateurs juniors des styles. Un convertisseur est validé par l’équipe de support et celle de développement. Un bridge est validé par l’équipe des extensions et celle de développement. Les packs de langue sont validés par l’équipe des traducteurs. Quant aux outils officiels, ils sont créés et validés par les différentes équipes de phpBB.com.
Haut