Ajouter un blog à votre application Laravel avec Hyvor Blogs

Vous avez déjà une application Laravel et vous souhaitez y ajouter un blog ? Ce guide est fait pour vous !

Hyvor Blogs est une plateforme de blog simple et puissante. Dans ce tutoriel, nous allons voir comment créer un blog avec Hyvor Blogs et l'héberger dans la route /blog de votre application Laravel. Tout le contenu du blog sera stocké dans un cache de votre application, que vous pouvez personnaliser. Nous utiliserons des webhooks pour l'invalidation du cache.

Partie 1 : Configurer les blogs Hyvor

Dans cette partie, nous allons créer un blog et configurer les paramètres de base nécessaires à l'auto-hébergement.

• Tout d'abord, créez un blog dans la console Hyvor Blogs. Vous obtiendrez un sous-domaine, dont vous aurez besoin à l'étape suivante.

• Allez dans Paramètres → Hébergement

  • Mettre à jour l'hébergement sur/à en auto-hébergement

  • Définissez l'URL de l'auto-hébergement à l'URL absolue de la route du blog de votre application Laravel. Pour ce tutoriel, définissez-la à https://mywebsite.com/blog. Vous pouvez personnaliser la route /blog plus tard si nécessaire.
    
    Remarque: pour tester les webhooks, cette URL doit être accessible au public. Par conséquent, si vous testez localement, nous vous recommandons d'utiliser un outil comme ngrok pour exposer temporairement votre site Laravel sur Internet.
    

  • Cliquez sur Enregistrer

    

• Allez dans Paramètres → Clés API

  • Cliquez sur CRÉER

    • Donnez un nom (ex : "For Laravel Blog")

    • Sélectionner Delivery API comme API

    • Créer une clé API

    

Cette clé API sera nécessaire à l'étape suivante.

• Allez dans Paramètres → Webhooks et créez un Webhook avec les valeurs suivantes.

  • URL : Définissez-la à "l'URL de votre site web + /hyvorblogs/webhook". Ex : https://mywebsite.com/hyvorblogs/webhook

  • Sélectionnez les événements suivants

    • cache.single

    • cache.templates

    • cache.all

Vous aurez besoin du Webhook Secret dans l'étape suivante.

Partie 2 : Configurer l'application Laravel

Dans cette partie, nous allons configurer votre application Laravel pour qu'elle "communique" avec les APIs/Webhooks de Hyvor Blogs afin de rendre votre blog correctement.

Tout d'abord, installez le package hyvor/hyvor-blogs-laravel Laravel dans votre projet en utilisant composer.

composer require hyvor/hyvor-blogs-laravel

Ensuite, exécutez la commande suivante pour générer le fichier de configuration.

php artisan vendor:publish --provider="Hyvor\HyvorBlogs\HyvorBlogsServiceProvider" --tag="config"

Cette commande copiera le fichier de configuration par défaut dans config/hyvorblogs.php dans votre application, où vous configurerez le blog.

 1<?php
 2
 3return [
 4    
 5    'blogs' => [
 6        [
 7            'subdomain' => '',
 8            'delivery_api_key' => '',
 9            'webhook_secret' => null,
10            'route' => '/blog',
11            'cache_store' => null,
12            'middleware' => [],
13        ],
14    ],
15
16];

La cléblogs contient un tableau de configurations de blogs. Elle vous permet de configurer plusieurs blogs dans la même application Laravel. Configurons un blog.

• Définissez le sous-domaine comme étant le sous-domaine du blog que vous avez créé à la première étape. Vous pouvez l'obtenir dans Console → Paramètres -> Hébergement.

• Définissez delivery_api_key sur la clé API de livraison que vous avez créée précédemment dans Console → Paramètres -> Clés API.

• Définissez webhook_secret sur le secret que vous avez obtenu dans Console → Paramètres -> Webhook.

• Définissez route comme le chemin de base de votre blog dans l'application Laravel. Si vous changez cela, assurez-vous de mettre à jour l'URL d'hébergement dans la console.

• (optionnel) Définissez cache_store pour utiliser un magasin de cache personnalisé pour mettre en cache votre blog.

• (optionnel) Si vous avez besoin d'ajouter un middleware supplémentaire, utilisez le tableau middleware.

Maintenant, essayez de visiter le chemin /blog de votre blog. Si tout va bien, votre blog devrait s'y afficher. Essayez de mettre à jour un article pour vous assurer que les webhooks fonctionnent.

Pour finir

• Si vous avez des problèmes, commentez ci-dessous ou contactez le support.

• Si vous souhaitez savoir comment cela fonctionne en interne, consultez notre documentation sur l'auto-hébergement avec des frameworks web.

• Une fois que vous avez tout configuré, vous pouvez personnaliser le thème de votre blog et commencer à écrire. Notre documentation contient toutes les informations dont vous avez besoin.

• Si vous souhaitez mettre en place plusieurs blogs au sein d'une même application, vous pouvez ajouter d'autres tableaux de configuration au tableau blogs dans le fichier de configuration.

• Des problèmes avec le paquetage Laravel ? Soumettez un problème ou contribuez à Github.