Ce guide explique comment utiliser la fonctionnalité de publication de pages (Page Publishing) sur Discourse. Cette fonctionnalité permet aux utilisateurs du personnel de convertir un sujet en une page statique autonome avec un style personnalisé. Des exemples incluent les pages de conditions d’utilisation et de politique de confidentialité.
Niveau utilisateur requis : Personnel
Publication de pages statiques sur Discourse
La publication de pages permet aux utilisateurs du personnel de créer des pages statiques autonomes à partir de sujets. Ceci est similaire au processus de création des pages de conditions d’utilisation ou de politique de confidentialité.
Résumé
Cette documentation couvrira :
- Activation de la publication de pages
- Publication d’un sujet en tant que page
- Dépublication d’un sujet
- Problèmes courants et solutions
- FAQ
- Ressources supplémentaires
Activation de la publication de pages
- Accédez à
Admin>Settings(Paramètres).- Activez le paramètre
enable page publishing(activer la publication de pages).
Activation de la publication de pages lorsque la connexion est requise
Pour que les pages publiées soient visibles même lorsqu’un utilisateur n’est pas connecté :
- Activez le paramètre
show_published_pages_login_requiredsousAdmin>Settings(Paramètres).
Publication d’un sujet
Allez au premier message d’un sujet public et sélectionnez l’icône d’ellipse (
...).
Sélectionnez l’icône de clé à molette.
Choisissez l’option « Page Publishing » (Publication de page).
Une boîte de dialogue modale apparaîtra, vous permettant de confirmer le slug (qui peut être pré-rempli à partir du titre du message) et de prévisualiser l’URL de la page publiée.
Pour autoriser la publication de pages, il est nécessaire de désactiver les paramètres du site concernant les téléchargements sécurisés.
\u003csmall\u003e:information_source: Pour les sites hébergés, les téléchargements sécurisés sont limités au plan Entreprise.\u003c/small\u003e
Sujet publié
Si l’option
Publicest cochée, une étiquette \u003ckbd\u003epublic\u003c/kbd\u003e apparaîtra.
Un sujet publié affichera une notification sous le titre permettant d’accéder à ses paramètres de publication.
Page publiée
Dépublication d’un sujet
Sélectionnez
Publishing Settings(Paramètres de publication) sous la notification.
Cliquez sur \u003ckbd\u003eUnpublish\u003c/kbd\u003e (Dépublier)
La page est dépubliée.
Problèmes courants et solutions
Impossible de voir les pages publiées lorsque l’on est déconnecté
Assurez-vous que le paramètre
show_published_pages_login_requiredest activé dansAdmin>Settings(Paramètres).Ajouter un en-tête Discourse aux pages publiées
Actuellement, les pages statiques sont conçues pour être minimalistes et n’incluent pas l’en-tête et le pied de page typiques de Discourse.
FAQ
Puis-je rendre une page FAQ ou À propos publique ?
Vous pouvez créer un nouveau sujet avec le contenu souhaité et le publier en tant que page. Modifiez les liens dans les paramètres du site pour pointer vers ces nouvelles pages.
Comment puis-je personnaliser l’apparence d’une page publiée ?
Utilisez la structure du document HTML et les sélecteurs CSS correspondants pour appliquer des styles personnalisés sous
Admin>Customize(Personnaliser) >Themes(Thèmes) >CSS.Ressources supplémentaires
Je dois encore essayer cela moi-même, donc ce qui suit n’est peut-être pas fondé sur la réalité, mais :
Il me semble que ce modèle de permissions crée un scénario où vous voyez toujours deux copies du contenu des pages : une dans la catégorie Discourse concernée, et une dans les pages publiées elles-mêmes. Cela semble évidemment redondant si vous souhaitez publier des pages destinées au grand public qui sont similaires, voire identiques, à votre base d’utilisateurs Discourse.
D’un autre côté, si les pages disposaient du drapeau « lisible par tous », vous pourriez alors restreindre l’accès en lecture ou en modification à un petit groupe, et le seul endroit où le contenu serait accessible aux autres utilisateurs de Discourse serait dans les liens publiés eux-mêmes.
(Je pense ici à un cas d’usage de « site de documentation ».)
Autrement, je suis très enthousiaste à l’idée de tester cela !
Superbe, et merci encore d’écouter vos utilisateurs. J’adore l’ambiance « améliorons cela pour nous tous » qui règne sur Discourse ! Nous en ferons un usage intensif.
Lors de la discussion d’un cas d’usage (la réparation d’une installation qui a mal tourné), un autre utilisateur a souligné un dernier petit détail qui pourrait être ajouté au gâteau :
Hé, y a-t-il un moyen d’ajouter la possibilité de rendre /faq et /about publics également, car ils sont actuellement masqués sur les sites nécessitant une connexion. Nous pouvons bien sûr utiliser la fonctionnalité existante que vous venez de publier pour /faq en créant la nôtre, en modifiant le lien dans les paramètres et en y ajoutant un lien explicite. Cependant, ce n’est pas élégant et la navigation existante vers celle-ci reste masquée. Nous ne pouvons absolument pas faire cela pour /about, bien sûr.
Un complément idéal pour cette fonctionnalité serait de rendre les publications compatibles OneBox, afin que les utilisateurs puissent facilement partager le contenu.
Veuillez excuser mon ignorance, car je suis vraiment débutant dans le domaine du HTML/CSS. Cependant, comment pouvons-nous appliquer nos choix de couleurs de thème aux pages publiées ? Dans sa forme la plus simple, j’aimerais utiliser un fond sombre et du texte blanc pour offrir aux pages publiées la même expérience de mode sombre que lors de l’accès à nos forums.
Ceci est-il déjà inclus dans le produit, ou dois-je manipuler le HTML/CSS ? Dans le second cas, quelqu’un pourrait-il me donner quelques pistes dans la bonne direction ? Merci !
Pourriez-vous en faire une demande de fonctionnalité distincte, s’il vous plaît ? Cela n’est pas lié à la publication de pages, car je n’aurais pas besoin de modifier quoi que ce soit concernant la publication de pages pour rendre cela possible. Je suis d’accord pour dire qu’il serait préférable que toutes ces pages « statiques » aient un comportement plus ou moins identique, mais il existe plusieurs solutions ici (ne rien faire ? ajouter des paramètres du site ? migrer ces pages vers la publication de pages ?). Nous pourrions donc souhaiter créer un sujet dédié à cette question.
GTM non chargé sur les pages publiées ? Ce serait bien.
Hmm, c’est vraiment un excellent point.
Je cherche juste une solution ici… cela fonctionnerait-il si type="text/javascript" et type="text/discourse-plugin" étaient traités différemment ? L’API a besoin de ce dernier, n’est-ce pas ?
Oui, je pense que nous prenons déjà en charge l’utilisation de text/javascript dans les champs du thème, il existe donc certainement des solutions dans ce domaine.
Ce serait formidable.
Donc, il est actuellement impossible d’avoir des pages publiées adaptatives, et ce site souhaite particulièrement :
- que les images soient disponibles lors du partage sur les médias publics, et
- que les images adaptatives/redimensionnées soient affichées, en particulier sur mobile — oh, le mobile pourrait simplement redimensionner l’image avec du CSS — cela devrait fonctionner, non ?
+1 pour l’intégration de l’en-tête Discourse dans les pages publiées. Je regrette l’absence de mon logo de site web, de mes liens d’en-tête personnalisés et de mon menu hamburger tant apprécié 
Autre bizarrerie : dans les messages, mes images en lightbox s’ouvrent dans une jolie fenêtre contextuelle, tandis que dans les pages publiées, elles s’ouvrent dans un nouvel onglet…
Je pense qu’il faut un ensemble de composants de thème qui ajoutent cela. Le dernier client pour qui j’ai dû l’utiliser voulait supprimer le créateur de sujet. Je pense qu’il est difficile de deviner ce qui répondra aux besoins des gens à ce sujet !
Y a-t-il actuellement des initiatives en cours pour ajouter un support JavaScript « simple » (non-API) aux pages publiées ? Ou devrions-nous oublier cela à court ou moyen terme ?
Puis-je afficher du JSON externe non-Discourse sur cette page ? Comme nous ne pouvons pas utiliser de code PHP ici et que Discourse supprime la plupart du HTML, je ne sais pas comment procéder…
J’ai un problème avec une page publiée : le bouton pour copier le contenu du bloc de code n’est pas visible sur la page publiée. Capture d’écran : Screenshot by Lightshot. Je passe la souris sur le bloc, mais le bouton n’apparaît pas. Une fois connecté, tout fonctionne normalement.
Quelqu’un peut-il reproduire le problème ? Une solution ?
Merci @riking !
Il semble en effet que le « texte » text/javascript « régulier » s’exécute sur les pages publiées lorsqu’il se trouve dans l’en-tête ou le pied de page d’un composant de thème.
Ha ! Il semble donc qu’il existe une solution de contournement pour faire fonctionner certains composants de thème avec la publication de pages.
Je me penche sur l’ajout d’un en-tête ou d’un pied de page aux pages publiées, et les composants de thème semblent être la bonne approche. Mais il me semble risqué de mettre en œuvre quelque chose qui pourrait potentiellement être cassé dans un avenir proche.
@riking, il semble que le type text/javascript dans header ou footer fonctionnant sur les pages publiées était involontaire. Est-ce que cela va être corrigé ou utilisé pour étendre les pages publiées ?
@syl, l’auteur de DiscPage, a évoqué la possibilité de réimplémenter le plugin DiscPage en utilisant les fonctionnalités de publication de pages. Est-ce que tu as toujours cela en tête, @syl ? Selon toi, quelle serait la voie de moindre résistance pour intégrer les deux fonctionnalités, @riking ?
Malheureusement, la fonctionnalité « Publication de pages » ne répond pas à mes besoins. Pour que je puisse l’utiliser, les pages publiées devraient :
- être affichées dans la mise en page normale de Discourse, c’est-à-dire avec l’en-tête standard de Discourse (tout comme les Conditions d’utilisation et la Politique de confidentialité), et
- être rendues comme des sujets normaux (avec mise en forme), c’est-à-dire en prenant en charge le bbcode et les plugins.
En attendant, j’ai utilisé l’outil de personnalisation par défaut de Discourse :
- Identifier l’élément ajouté, par exemple avec une classe CSS
published-page-footer-links. - Personnaliser le CSS pour masquer cet élément par défaut et ne l’afficher que sur les pages publiées.
- Ajouter l’élément dans l’espace
Footer.
2. Dans le CSS, ajoutez :
/* Afficher les liens du pied de page uniquement sur les pages publiées */
.published-page-footer-links { display: none; }
.published-page .published-page-footer-links { display: block;}
3. Dans Footer, ajoutez :
<nav class="published-page-footer-links">
Bonjour ! Ceci est le pied de page pour les pages publiées !
</nav>