Flux RSS - La vie du site - Nouveautés et mises à jour
Assiste.com - Sécurité informatique - Vie privée sur le Web - Neutralité d'Internet Assiste.com - Sécurité informatique - Vie privée sur le Web - Neutralité d'Internet

Keetag - Ajouter Keetag à votre site ou application

Keetag - Ajouter rapidement le convertisseur de texte Keetag à votre site ou application grâce à ses API. Keetag est très facilement intégrable dans votre propre site web, logiciel, application mobile, extension de navigateur ou tout autre support.

26.03.2016 - Révision 01.07.2021 - Révision mineure 01.02.2022. Auteur : Pierre Pinard.

Ajouter rapidement le convertisseur de texte Keetag [1] [2] à votre site ou application. Grâce à ses API, le convertisseur Keetag est très facilement intégrable dans votre propre site web, logiciel, application mobile, extension de navigateur ou tout autre support.

Cette méthode ne requiert aucune compétence en programmation ni aucune manipulation de code. Le seul prérequis est que vous devez disposer d'un hébergement web.

  1. Téléchargez le convertisseur complet (interface HTML + code de conversion de texte) :
    Télécharger le convertisseur

  2. Ouvrez le fichier .zip que vous venez de télécharger et placez le dossier "keetag" qu'il contient sur votre serveur (en utilisant un client FTP tel que FileZilla).

    Dézipper (décompresser) le dossier Keetag
    Dézipper (décompresser) le dossier Keetag

    keetag.net - Keetag - API   keetag.net - Keetag - API   keetag.net - Keetag - API

    Le dossier Keetag décompressé
    Le dossier Keetag décompressé
  3. Le convertisseur est désormais installé sur votre site ! Vérifiez qu'il est accessible :

  4. Il vous reste à configurer le langage de départ et d'arrivée que vous souhaitez pour vos conversions. Pour cela, ouvrez le fichier "config.ini" dans un éditeur de texte et remplacez les identifiants existants par les ID adéquats (liste des ID des langages d'entrée et de sortie).

    Configurer Keetag
    Configurer Keetag

En pratique, vous souhaiterez sans doute intégrer le convertisseur dans une de vos propres pages. Vous pouvez le faire facilement en reprenant les éléments HTML de l'interface. Ceux-ci sont réduits au strict nécessaire afin que la structure soit claire et intuitive, même si vous n'êtes pas familiers avec le HTML.

Si votre site est en PHP, le moyen le plus simple et rapide d'appeler l'API est d'utiliser la librairie KeetagCaller. Si vous avez besoin d'un autre langage (Python, Javascript...), consultez la section Mise en place rapide sans librairie.

  1. Téléchargez la librairie KeetagCaller et placez-la sur votre serveur.

  2. Intégrez le convertisseur dans votre site sur ce modèle. Vous aurez besoin de connaître l'ID du langage de départ et de celui d'arrivée, pour cela consultez la liste des langages pris en charge.

    <?php
    // Includes the Keetag library
    require 'KeetagCaller.php';
    $keetag = new KeetagCaller();
    // Example of text to convert. In your real site, you will probably replace
    // this hard coded text with something like $_POST['text_to_convert']
    $text_to_convert = 'Hello <b>World</b>!
    Use the powerful <a href="https://keetag.net">Keetag converter</a>
    to implement formatting tags on your site very easily.';
    // The text is in HTML, so we set "1" (ID of the HTML language on Keetag)
    $orig_language_id   = 1;
    // We want to convert the text to BBcode, so we set "2" (ID of the BBCode language)
    $destin_language_id = 2;
    // Converts the text
    $result = $keetag->convert_text($text_to_convert, $orig_language_id, $destin_language_id);
    // Displays the text after conversion
    echo $result['converted_text'];


  3. Astuce :

    Vous pouvez également définir les langages de départ et d'arrivée une fois pour toutes avec set_option(). Ainsi, vous n'aurez pas besoin de les préciser en paramètre à chaque appel de convert_text() :

    <?php
    // Sets the original et destination languages
    $keetag->set_option('orig_language_id',   $orig_language_id);
    $keetag->set_option('destin_language_id', $destin_language_id);
    // Converts the text, with only one parameter
    $result = $keetag->convert_text($text_to_convert);
    // Displays the text after conversion
    echo $result['converted_text'];
Keetag - API - Méthode 2 - Méthode rapide avec la librairie KeetagCaller

Les exemples de code sont en PHP, mais vous pouvez bien sûr les transposer dans le langage de votre choix.

  1. Commençons par définir les 3 variables qui serviront pour la conversion. Pour connaître les ID des langages de départ et d'arrivée, consultez la liste des langages pris en charge.

    
    // Example of text to convert. In your real site, you will probably replace
    // this hard coded text with something like $_POST['text_to_convert']
    $text_to_convert = 'Hello <b>World</b>!
    Use the powerful <a href="https://keetag.net">Keetag converter</a>
    to implement formatting tags on your site very easily.';
    // The text is in HTML, so we set "1" (ID of the HTML language on Keetag)
    $orig_language_id   = 1;
    // We want to convert the text to BBcode, so we set "2" (ID of the BBCode language)
    $destin_language_id = 2;
  2. Votre texte sera envoyé à la page de l'API grâce à la méthode POST.
    Pour faire cela sans recourir à un formulaire HTML, utilisez la fonction stream_context_create()
    en PHP (ou son équivalent dans un autre langage). Vous pouvez copier le code ci-dessous sans le modifier :

    $stream = stream_context_create([
        'http' => [
            'method'  => 'POST',
            // Important : sets a user agent
            'header'  => "Content-type: application/x-www-form-urlencoded\r\n"
                        ."User-Agent: Mozilla/4.0 (compatible; MSIE 6.0)\r\n",
            // Your datas for the conversion are applied here
            'content' => http_build_query([
                'text_to_convert'       => $text_to_convert,
                'orig_language_id'      => $orig_language_id,
                'destin_language_id'    => $destin_language_id
                ])
            ]
        ]);

    Remarquez que ce code envoie un user agent. Ceci est indispensable quel que soit le langage que vous utilisez. Si vous ne le faites pas, le serveur retournera une erreur « 403/forbidden » et votre script ne pourra pas accéder à l'API.

  3. Vous devez à présent envoyer ces données à la page de l'API. En PHP, utilisez la fonction native file_get_contents() :

    $json = file_get_contents('https://keetag.net/en/api/v1/converter', FALSE, $stream);

    Vous pouvez utiliser un outil plus performant comme cURL s'il est disponible sur votre plateforme.

  4. Ce que vous venez de récupérer est un flux texte au format JSON. Pour le manipuler avec PHP, transformez-le en array avec la fonction json_decode() :

    $result = json_decode($json, TRUE);

    Si votre version de PHP ne contient pas la fonction json_decode() (versions antérieures à PHP 5.2), vous pouvez l'y ajouter grâce à cette astuce archivée (utilisation du package « Services_JSON »).

    Le texte converti se trouve dans la clé "converted_text" :

    echo $result['converted_text'];
Keetag - API - Méthode 3 – Mise en place rapide sans librairie


# Ailleurs sur le Web #

  1. #Keetag - API#

  2. #keetag#