1.a) Utiliser notre code d'intégration universel (avec vidéo)

Logora peut être installé sur n'importe quel site en insérant le code natif JavaScript. La documentation ci-après est à destination des développeurs. Logora propose également une documentation personnalisée pour l'installation Wordpress.

L'installation en Javascript se fait en deux temps 

1.  Insérer la synthèse des débats 
2.  Insérer l'espace de débat

Avant de commencer 

<div class="logora_synthese" data-object-id="logora_config"></div>
<script>
    // Variables de configuration
    var logora_config = {
        shortname: "NOM_APPLICATION", // Nom d'application présent dans votre espace d'administration
        debate: {
            identifier: "PAGE_IDENTIFIER" // Identifiant unique de la page
        }
    };

    (function() {
        var d = document, s = d.createElement('script');
        s.src = 'https://api.logora.fr/synthese.js'; 
        (d.head || d.body).appendChild(s);
    })();
</script>

Variables de configuration

shortname (requis) : nom d'application fourni par Logora et présent dans votre espace d'administration à l'onglet Paramètres > Général.

debate.identifier (requis) : identifiant unique lié à la page. Cet identifiant doit être unique pour chaque page où est insérée la synthèse. Il permettra de récupérer le débat correspondant à la page. Par exemple, l'identifiant peut être l'ID dans votre base de données de l'article présent sur la page, ou un slug unique ('exemple-identifiant').

Le débat lié à la page doit ensuite être créé dans l'espace d'administration > créer un débat, en fournissant l'identifiant debate.identifier ou en sélectionnant l'article concerné dans la liste des derniers articles récupérés. Pour en savoir plus sur la création de débat, lisez l'article Comment créer un débat ? 

Si aucun débat n'est créé, la synthèse ne s'affichera pas.

Option avancée : 

Les débat peuvent aussi être créés automatiquement au chargement de la synthèse, à partir des variables de configuration, sans passer par l'espace d'administration. Pour cela, voir Comment créer les débats automatiquement depuis la synthèse ?

2. Installer l'espace de débat 

Contrairement à la synthèse, l'espace de débat est inséré dans une page dédiée. 

Prenons l'exemple d'un site web disponible à l'adresse https://exemple.com. L'éditeur du site web souhaite accéder à l'espace de débat via l'adresse https://exemple.com/espace-debat. Voici les étapes à suivre pour insérer l'espace de débat :

1. Ajouter une page pour insérer l'espace de débat

Créez une page dédiée où sera inséré l'espace de débat. Cette page est disponible à l'adresse https://exemple.com/espace-debat. Le préfixe 'espace-debat' est le préfixe par défaut. Il est modifiable dans l'espace d'administration.

2. Insérer le code JavaScript et vos variables de configuration

Insérez le code Javascript du débat à l'endroit où vous souhaitez voir apparaître l'espace de débat. 

L'ID logora_app est l'endroit où l'espace de débat est chargé.

Code standard à copier/coller et compléter : 

<div id="logora_app"></div>
<script>
    // Variables de configuration
    var logora_config = {
        shortname: "NOM_APPLICATION" // Nom d'application présent dans votre espace d'administration
    };

    (function() {
        var d = document, s = d.createElement('script');
        s.src = 'https://api.logora.fr/debat.js';
        (d.head || d.body).appendChild(s);
    })();
</script>

Variables de configuration

shortname (requis) : nom d'application fourni par Logora et présent dans votre espace d'administration à l'onglet Paramètres > Général.

Les variables de configuration sont là aussi nécessaires pour adapter l'espace de débat à vos besoins. Voir l'article Variables de configuration JavaScript pour plus d'informations.

Vous verrez alors sur votre page la barre de navigation et le pied de page Logora, séparés par un espace vide.

3. Réécriture des URLs pour les routes de l'espace de débat

Utilisez la réécriture d'URL sur votre plateforme ou CMS pour que les chemins commençant par 'espace-debat/' (ou le préfixe que vous avez choisi) pointent vers la page où est inséré l'espace de débat.

Accédez à la page https://exemple.com/espace-debat/debats. Vous êtes sur la page d'accueil de l'espace de débat !

Pour modifier le préfixe et les chemins d'URLs des pages de l'espace de débat, rendez-vous sur Quelles sont les routes de l'espace de débat ?.

Il ne reste plus qu'à implémenter la connexion et personnaliser Logora pour lancer votre premier débat. 

Pour terminer l'installation voici l'article suivant vous permettant de gérer le SSO :

• Implémenter l'Authentification Unique (Single Sign-on)