Configuration des sélecteurs d'intégration autorisés

[Discourse]

Ce guide explique comment configurer le paramètre « sélecteurs d’intégration autorisés » dans Discourse. Ce paramètre est crucial lorsque vous publiez des messages depuis un site externe vers Discourse ou lorsque vous intégrez des commentaires Discourse sur un site externe en utilisant JavaScript.

Niveau d’utilisateur requis : Administrateur

Des connaissances en CSS sont nécessaires pour une utilisation plus avancée

Lorsque vous publiez des messages sur Discourse depuis un site externe ou que vous intégrez des commentaires Discourse sur un site externe, vous pourriez rencontrer des problèmes avec le bouton « Afficher le message complet » qui ne récupère pas le bon contenu. Ce guide vous aidera à configurer le paramètre « sélecteurs d’intégration autorisés » pour résoudre ce problème.

Comprendre le problème

Lorsque les utilisateurs cliquent sur le bouton « Afficher le message complet », Discourse peut ne pas récupérer le bon contenu du message depuis votre site externe. C’est ici que le paramètre « sélecteurs d’intégration autorisés » entre en jeu.

Localiser le paramètre

Vous pouvez trouver le paramètre « sélecteurs d’intégration autorisés » à deux endroits :

1. Recherchez « sélecteurs d’intégration autorisés » sur la page des paramètres de votre site.
2. Accédez à Admin > Personnaliser > Intégration, puis sélectionnez l’onglet Crawlers.
   
   

Identifier les bons sélecteurs CSS

Pour trouver les sélecteurs CSS appropriés :

1. Allez sur un message de votre site externe que vous avez publié sur Discourse.
2. Ouvrez l’inspecteur web de votre navigateur et examinez la structure HTML du message.
3. Identifiez les éléments HTML qui entourent immédiatement le contenu principal du message.

Par exemple, dans un message typique WordPress, le contenu se trouve souvent dans un div .entry-content à l’intérieur de balises article. Dans ce cas, vous pourriez utiliser article .entry-content comme sélecteur CSS.

Configurer le paramètre

Pour récupérer divers types de contenu depuis votre site externe, vous devrez peut-être ajouter plusieurs sélecteurs. Par exemple :

article .entry-content img, article .entry-content p, article .entry-content ul

Cet exemple cible les images, les paragraphes et les listes non ordonnées à l’intérieur du contenu d’entrée de l’article.

Tester et dépanner

Trouver les bons sélecteurs peut nécessiter quelques essais et erreurs. Gardez à l’esprit :

1. Discourse met en cache le contenu des messages externes pendant 10 minutes, donc les modifications peuvent ne pas être immédiatement visibles.
2. Pour contourner cela, testez avec plusieurs messages ou videz le cache sur un site de développement en utilisant Rails.cache.clear dans la console Rails.

Gestion des images

Si vous rencontrez des difficultés pour récupérer les images de votre site web, assurez-vous que vos sélecteurs CSS incluent les éléments d’image appropriés. Par exemple :

article .entry-content img

Ce sélecteur cible les images à l’intérieur du contenu d’entrée de l’article.

Considérations supplémentaires

• Le paramètre « sélecteurs d’intégration autorisés » s’applique à la fois aux messages publiés via l’API et aux messages récupérés avec le script d’intégration Discourse.
• Vous devrez peut-être ajuster les sélecteurs en fonction de la structure spécifique de votre site web et des types de contenu.
• N’oubliez pas d’enregistrer vos modifications après avoir mis à jour le paramètre.

[Bank_Live]

Puis-je récupérer des images sur mon site web ? Je ne vois pas d’images ?

[simon]

Il devrait être possible d’intégrer des images de votre site web. Il faudra peut-être quelques essais et erreurs pour trouver les bons sélecteurs CSS à ajouter à votre paramètre de site sélecteurs d'intégration autorisés.

[Bank_Live]

Oui, cela fonctionne et nous pouvons ajouter automatiquement des images RSS au titre du message.