Plugin Related : première béta pour la version 1.0

dimanche 1 juin 2008

Oui. Vous avez bien lu : il est temps pour moi d'assumer une version 1.0 pour ce bon vieux Related Pages.
Il faut dire que le risque est mésuré : ce plugin a déjà eu l'occasion de faire ses preuves, au fil des version antérieures.

C'est d'ailleurs pour cette raison que je vais faire court.

Quels sont les changements ?

En apparence, il n'y en a quasiment aucun. :-)

Tout au plus un ou deux éléments qui changent de style. L'utilisation reste donc parfaitement identique, malgré un ré-aménagement de certaines portions du code.

La grande nouveauté est l'apparition de la prise en charge des marqueurs de templates Dotclear2, au sein des fichiers XHTML que l'on peut inclure dans les pages. En effet, désormais si vous choisissez d'inclure un fichier .html, les éventuelles balises {{tpl:xxx}} ou <tpl:xxx> seront transmises au moteur de templates de Dotclear2 et transformées en conséquence.

J'ai néanmoins glissé une petite restriction là au milieu : au moment du passage par le moteur de templates, seul le chemin du dépôt des pages du plugin sera scanné pour la recherche d'un fichier template. Cela signifie qu'en cas d'appel à {{tpl:include}}, le fichier désiré devra également être situé dans le dépôt.^[1]

Et ça se récupère où ?

Pour l'instant, essentiellement par là : archive ZIP (24 Ko).

Je ne mettrai pas le lien en page d'accueil, ni le plugin en téléchargement sur dotaddict.org, avant une première tournée de tests, et sans doute la version beta suivante.

Comme l'ensemble des nouveaux plugins ou nouvelles versions de plugins existants que je diffuse, seule la compatibilité avec Dotclear 2.0 RC1 ou plus est garantie.

Notes

[1] Il va de soi que si, à l'usage, cette restriction s'avère trop gênante, j'en reverrai le principe.

Commentaires

1. Par mirovinben, le 02/06/2008 à 08:52

Et hop ! téléchargé, dézippé, uploadé... Plus qu'à tester.
Merci Pep !

2. Par mirovinben, le 02/06/2008 à 09:18

J'ai mis en place un fichier external.html personnalisé par mes soins dans mes thèmes.

En comparant avec les versions antérieures, j'ai vu que body change de class : <body class="dc-related"> devient <body class="dc-page">. Perso je resterai avec "dc-related"...

Reste plus qu'à faire mumuse avec les marqueurs de templates.

3. Par mirovinben, le 02/06/2008 à 09:56

Heu... ou j'ai pas tout capté, ou il y a un bug mais les marqueurs ne sont pas traités.

Pour être sûr de mes tests, j'ai normalisé en utilisant le fichier template external.html qui est dans (plugins)/related/default-templates et utilisé un marqueur standard (au hasard : tpl:BlogThemeURL ).

Je n'utilise que des fichiers locaux de mon dépôt de pages connexes intégrés à la base via "nouvelle page incluse". J'ai vidé moultes fois le cache de DC2, désactivé le cache de Firefox. Rien n'y fait.

Petite précision : les plugins autres que ceux fournis avec DC2 sont dans un répertoire dc2plugins placé hors du répertoire de DC2.

4. Par mirovinben, le 02/06/2008 à 10:23

Bon, après quelques recherches et essais, il faut absolument que la page ait l'extension *.html et non *.php (comme avant) dans le répertoire de dépôt des pages connexes pour avoir une bonne prise en compte des marqueurs de templates.

En relisant ton billet, c'est bien indiqué mais pas assez fortement pour un cerveau lent comme le mien.

Mais du coup on ne peut avoir aisément les deux : marqueurs et bouts de code php : entre le beurre, l'argent du beurre et le sourire de la crémière il faut choisir.

Désolé pour le dérangement.

5. Par Pep, le 02/06/2008 à 11:22

mirovinben > Tu peux avoir le beurre, l'argent du beurre et le sourire de la crémière si tu mets tes morceaux de PHP dans un .html, et que tu autorises la prise en compte de PHP dans le moteur de template de Dotclear (depuis about:config, en passant la directive tpl_allow_php à oui).

C'est pour cette raison que je préfère recourir à une distinction claire entre le traitement des .php et celui des .html.

6. Par mirovinben, le 02/06/2008 à 12:43

Je suis d'accord avec toi. Il est préférable de recourir à une distinction claire entre le traitement des .php et celui des .html. J'évoquais le beurre, l'argent du beurre (...) pour info complétant ton billet puisque le plugin autorise deux modes de fonctionnement : PHP avec *.php et marqueurs de templates avec *.html en plus du mode "billet". Et je pense qu'il est bon d'insister sur cette évolution majeure.

Perso je n'ai jamais voulu autoriser la prise en compte de PHP dans le moteur de template de Dotclear. Pas de raison particulière pour cela, peut-être un côté meilleure sécurité qui reste à prouver.

Merci encore pour cette évolution plus qu'intéressante.

7. Par brol, le 17/06/2008 à 17:49

Quand on insère une page related, elle s'intègre dans le blog mais à partir de quelle page template ?
A noter qu'il a fallut que je crée via ftp le dossier /public/related à la mimine.

8. Par Pep, le 17/06/2008 à 18:11

brol > Le template utilisé est nommé external.html, et fourni par défaut dans le dossier default-templates/ du plugin. Pour personnaliser le rendu, il est donc possible de créer son propre external.html et de le déposer dans le thème courant.

Pour ce qui est du dossier related/ dans public/, peux-tu me confirmer qu'il n'y avait pas un problème de droits sur ton serveur ?

9. Par brol, le 18/06/2008 à 02:40

Pour le template, j'ai lu ça dans les commentaires plus haut... Poil dans la main.

A priori, pas de pb de droits sur le serveur (mutualisé 1&1 teuton) puisque le 755 de base est largement dédaigné tout comme un franc 777. Dans tous les cas, l'injure "Le répertoire pour le dépôt des fichiers liés nécessite un accès en lecture et écriture." déboule triomphalement...
Un complot, aucun doute !

10. Par Pep, le 24/06/2008 à 17:51

Ouaip. Je confirme.
Je viens d'avoir ce souci de répertoire en partant d'une installation fraiche de Dotclear2.

Je regarderai et corrigerai ça dès que possible.

11. Par Léo, le 11/07/2008 à 14:26

Je confirme le problème de droit sur le répertoire related/ dans public/, malgré un chmod 777. C'est un environnement local avec Dotclear 2.0 RC2.1

12. Par djedie, le 30/07/2008 à 19:11

Salut Pep,

question ::
J'utilise ton plugin pour faire un peu de php sur une page speciale.
Sur cette page je fais aussi de l'ajax et donc comme tu le sais, ca appelle une autre page php pour faire des trucs en background.

Le probleme, c'est qu'a l'appel de cette page (declaree en admin dans le plugin related), ca fait une sorte de double affichage en html.

je sais pas si c'est super clair, mais en gros, au lieu de faire du background, bah tout se juxtapose...

Est-il possible d'appeler du php sans qu'il soit dans le plugin related (avec donc inclusion de la page externe.html)

si c'est pas clair, dis le tout de suite et j'essaierai de me clarifier... ;)

13. Par Pep, le 01/08/2008 à 03:51

Léo > Je compte corriger cela dans les prochaines semaines, au moment de la livraison d'une beta2. :-)

djedie > Si tu as besoin du contexte de DC2 dans le PHP appelé, je pense que le passage par l'écriture d'un petit plugin spécifique pourrait être intéressant. Si le contexte DC2 n'est pas utilisé, un simple PHP placé où bon te semble fera l'affaire.
Mais dans un cas comme dans l'autre, malheureusement, le plugin Related ne te servira pas.

PS : Désolé, ton commentaire avait été marqué comme spam.

14. Par Themax, le 11/08/2008 à 20:12

Hello !
Super ce boulot ! ça m'ouvre de multiples horizons pour mes créations de sites ! Promis je fais un petit don dès que les sites me rapportent des sous !

Merci a mirovinben sur le forum de dotclear pour m'avoir amené à ce billet !

15. Par Iks, le 22/08/2008 à 10:39

Bonjour,

Tout d'abord merci Pep cette extension. Je débute en progra web et égallement aussi sur dotclear donc mes questions et mon poste risque de paraitre simpliste. Une question qui se pose à moi, ( et futurement un possible dilemme, ) est il possible de faire des "recherches" sur une page générée par le pluggin? Si oui cela est ce dur à mettre en place pour un "néophyte", sinon existerait il des méthodes pour faire des recherches sur des pages, ou billets connexes?

Merci pour tes ( ou vos ) réponses et indications, et encore merci pour ce travail.

16. Par Pep, le 23/08/2008 à 01:22

Iks > Les données des pages créées par le plugin sont dans un format quasi-identique à celui des simples billets. Elles sont donc stockées au même endroit et peuvent être récupérées à l'aide de nombreuses fonctions déjà existantes, simplement en changeant un paramètre ou deux.

Ce qui distingue clairement les pages Related des autres billets ou pages Dotclear2, c'est la propriété post_type. Elle vaut related au lieu de post ou page. Cette propriété peut généralement être précisée explicitement par les options de requêtes.

17. Par typhus, le 24/08/2008 à 22:43

Bonjour,
Lorsque j'installe le plugin related j'ai le message suivant qui s'affiche:
Call to undefined method dcCore::setPostType()dans le fichier _prepend.php
J'utilise Dotclear2 a partir de l'installation automatique proposée par OVH.
Avez-vous une idée du problème ?
Merci
PS j'ai le m^me message d'erreur avec le plugin page.

18. Par Pep, le 24/08/2008 à 23:17

typhus > La dernière version de Related, ainsi que toutes les versions de Pages, nécessitent Dotclear 2.0 Release (ou supérieur).

C'est donc que la version de l'installation automatique d'OVH n'est pas à jour. :-)

19. Par Iks, le 25/08/2008 à 10:26

peuvent être récupérées à l'aide de nombreuses fonctions déjà existantes, simplement en changeant un paramètre ou deux (...) Cette propriété peut généralement être précisée explicitement par les options de requêtes.

Dans le code source de DC2? j'ai vu un post permettant de faire cela sur le forum en effet, mais le problème ( que j'ai mal détaillé ) est que je ne peux pas toucher au code source de DC2. Donc uniquement modification d'extension. Ai-je le droit de trifouiller ton code?

20. Par Pep, le 25/08/2008 à 11:46

Iks > Sans souci. C'est sous licence GPL. :-)