Documentation Zekast.

§00 · Votre abonnement Zekast

0.1Comment ça marche

Zekast, c'est deux choses : un plugin que vous installez sur votre site WordPress, et un abonnement qui débloque les fonctionnalités payantes. Vos podcasts, vos épisodes, vos auditeurs restent chez vous, sur votre site.

Quatre formules : Free à 0 €, Starter à 12 €/mois, Pro à 39 €/mois, Studio à 79 €/mois. Le détail est sur la page Tarifs. Résiliable à tout moment, factures envoyées par email.

0.2Souscrire un plan

1. Sur la page Tarifs, choisissez votre plan et cliquez Souscrire.
2. Renseignez votre email et votre carte sur la page de paiement sécurisée, validez.
3. Vous êtes ramené sur Zekast. Votre compte et votre clé de licence sont créés automatiquement.

0.3Recevoir votre clé de licence

Dans les secondes qui suivent le paiement, vous recevez un email de bienvenue. Il contient :

• Votre clé de licence — c'est elle que vous allez coller dans le plugin.
• Un lien de connexion à votre compte, sans mot de passe (cliquez et c'est ouvert).
• Un lien pour télécharger le plugin si vous ne l'avez pas encore.

0.4Coller la clé dans le plugin

1. Installez et activez le plugin Zekast sur votre site WordPress (cf §1.1 plus bas).
2. Dans l'admin WordPress : Zekast → Réglages → Licence.
3. Collez la clé reçue par email dans le champ Clé de licence.
4. Cliquez Enregistrer. Vos fonctionnalités payantes sont actives immédiatement.

Votre plan et la date de fin d'abonnement s'affichent sous le champ. Le site apparaîtra aussi dans Mes sites sur votre compte Zekast peu de temps après.

0.5Gérer votre abonnement

Tout se passe dans votre compte Zekast : connectez-vous en saisissant votre email — on vous envoie un lien cliquable, pas besoin de mot de passe.

• Mon compte : votre plan actuel, ce qu'il vous reste à consommer (transcription, stockage…), vos factures.
• Mes sites : les sites où votre plugin est actif. Vous pouvez en désactiver un à distance pour libérer un slot.
• Téléchargements : les versions du plugin disponibles selon votre formule.
• Réglages : votre profil, changement d'email, authentification 2FA, suppression de compte.
• Gérer mon abonnement : le bouton qui vous ouvre la page où mettre à jour votre carte, télécharger vos factures, ou résilier.

0.6Changer de plan

Vous pouvez passer à un plan supérieur ou inférieur à tout moment, ou basculer entre mensuel et annuel :

1. Depuis votre compte, cliquez Passer à [plan].
2. L'écran de changement affiche le montant exact à payer aujourd'hui : on déduit ce qu'il vous reste sur l'ancien plan du prix du nouveau. Vous ne payez que la différence.
3. Confirmez, le changement est immédiat.

0.7Sécurité du compte

Dans Réglages, vous pouvez :

• Changer votre email — un lien de confirmation est envoyé à la nouvelle adresse. Tant que vous n'avez pas cliqué, le changement n'est pas effectif.
• Activer la double authentification (2FA) — vous scannez un QR code avec une application de codes à usage unique (Authenticator, 1Password, etc.). À chaque connexion, on vous demandera un code à 6 chiffres en plus du lien email.
• Supprimer votre compte — un lien de confirmation est envoyé à votre email pour éviter toute fausse manipulation. Cliquer le lien annule immédiatement votre abonnement, désactive le plugin sur tous vos sites, et supprime votre compte. Vos factures restent conservées pour des raisons légales.

0.8Pas reçu l'email ?

L'email arrive en général en moins d'une minute. Si vous ne le voyez pas :

1. Regardez dans vos spams ou l'onglet Promotions.
2. Vérifiez que vous êtes bien allé jusqu'au bout du paiement — un paiement abandonné en cours de route n'envoie pas l'email.
3. Essayez de vous connecter sur votre compte en saisissant l'email de paiement : si le compte existe, vous recevrez un nouveau lien de connexion.
4. Si toujours rien, écrivez à contact@zekast.studio depuis l'adresse utilisée pour le paiement — on vous renvoie la clé manuellement.

§01 · Démarrer

1.1Installer Zekast

1. Téléchargez le ZIP zekast-vX.Y.Z.zip depuis votre compte Zekast — le téléchargement est disponible sur tous les plans, plan Free inclus (créez un compte gratuit si besoin).
2. Dans WP Admin : Extensions → Ajouter → Téléverser une extension. Sélectionnez le ZIP, activez.
3. Un nouveau menu Zekast apparaît. Le wizard d'onboarding démarre automatiquement.

1.2Premier podcast

Depuis le wizard, choisissez "Créer un nouveau podcast" ou "Importer un flux existant".

Créer : renseignez le titre, la description, la langue, la catégorie Apple Podcasts et l'image de couverture. Votre flux RSS est disponible immédiatement à l'URL affichée dans le tableau de bord du plugin.

Importer : collez l'URL d'un flux RSS existant. Le plugin récupère vos épisodes, leurs métadonnées et les fichiers audio. Voir la section Migration pour les guides par hébergeur.

1.3Choisir une mise en page

Insérez le bloc Liste d'épisodes dans une page. Dans les réglages du bloc, choisissez l'une des 9 mises en page :

• Free : Grille de cartes, Liste standard, Liste avec progression, Lecteur classique
• Starter+ : Spotlight, Mosaïque, Liste compacte, Tableau, Lecteur partagé

1.4Publier votre premier épisode

Dans l'admin WordPress : Zekast → Episodes → Ajouter. Renseignez le titre, la description, le résumé et l'image, puis ajoutez votre fichier audio (depuis votre médiathèque ou directement vers l'hébergement Zekast). Placez les blocs Lecteur, Durée et Transcription où vous voulez sur la page, puis publiez. L'épisode part automatiquement dans votre flux RSS et apparaît chez Apple Podcasts, Spotify et les autres plateformes connectées sous quelques minutes à quelques heures.

§02 · Hébergement audio

2.1Hébergement géré Zekast (tous les plans)

Disponible sur tous les plans, plan Free inclus. Rien à configurer : vos fichiers audio sont hébergés sur le serveur Zekast et servis rapidement à vos auditeurs partout dans le monde, via un CDN. Tout est inclus dans votre abonnement.

Espace inclus : 1 Go en Free, 10 Go en Starter, 50 Go en Pro, 200 Go en Studio. Bande passante mensuelle : 5 Go / 50 Go / 250 Go / 1 To.

2.2Votre propre Bunny.net (tous les plans, un clic)

Disponible sur tous les plans. Dans les réglages du plugin, cliquez Connecter Bunny.net. Vous autorisez la connexion à votre compte Bunny, Zekast configure tout pour vous. Vous gardez la main sur votre propre stockage.

2.3Votre propre stockage S3

Disponible sur tous les plans. Compatible avec AWS S3, Backblaze B2, DigitalOcean Spaces, Wasabi, Cloudflare R2, Scaleway, MinIO. Si vous savez déjà ce qu'est S3, vous avez les champs habituels à remplir.

2.4Quotas et alertes

Votre consommation est visible dans le tableau de bord du plugin. Vous recevez un email automatique à 80 % puis 95 % de votre limite. Si vous dépassez, vous ne pouvez plus ajouter de nouveau fichier, mais vos auditeurs continuent d'écouter les épisodes déjà en ligne sans interruption.

§03 · Monétisation

3.1Connecter Stripe

À partir du plan Starter. Dans les réglages du plugin, cliquez Connecter Stripe : Stripe vous guide pour créer votre compte (ou connecter le vôtre s'il existe déjà), c'est l'affaire de quelques minutes. Une fois la connexion établie, l'argent de vos auditeurs arrive directement sur votre compte bancaire via Stripe. Zekast ne prend aucune commission — seuls les frais standards de Stripe s'appliquent (~1,5 % + 0,25 € par transaction pour une carte européenne).

3.2Activer les abonnements premium

Dans les réglages du plugin, créez un tier d'abonnement (par exemple "Bonus à 5 €/mois") et marquez les épisodes ou podcasts qui en font partie. Vos auditeurs s'abonnent depuis votre site, paient via Stripe, et reçoivent par email un flux RSS privé à ajouter dans leur app de podcast. Si un auditeur annule son abonnement, son accès est révoqué automatiquement.

Compatible avec Apple Podcasts, Pocket Casts, Overcast, Castbox et toutes les apps qui acceptent l'ajout manuel d'un flux RSS.

3.3TVA et auto-liquidation

Stripe peut calculer et collecter la TVA pour vous selon le pays de chaque auditeur (option à activer dans votre compte Stripe). Pour les ventes à des entreprises européennes avec numéro de TVA intracommunautaire valide, l'auto-liquidation s'applique automatiquement. Vos déclarations se gèrent ensuite directement depuis Stripe.

§04 · Transcription

4.1Crédits inclus (rien à configurer)

Inclus dans votre abonnement : 20 minutes par mois en Starter, 60 en Pro, 200 en Studio. Sur la page d'édition d'un épisode, cliquez Générer la transcription. Comptez environ 30 secondes pour un épisode d'une heure. Vous récupérez le texte, plus les fichiers de sous-titres pour vidéo.

4.2Votre propre clé OpenAI

Si vous avez besoin de plus que les crédits inclus, vous pouvez connecter votre propre compte OpenAI dans les réglages du plugin. Vos transcriptions sont alors facturées directement par OpenAI (environ 0,35 € par heure d'audio), sans toucher à vos crédits Zekast.

4.3Afficher la transcription

Insérez le bloc Transcription sur la page de l'épisode : le texte s'affiche replié par défaut, et l'auditeur peut le dérouler. La transcription est aussi envoyée dans votre flux RSS, ce qui permet à Apple Podcasts et Pocket Casts (versions récentes) de l'afficher directement dans leur app pendant l'écoute.

§05 · Diffusion

5.1Soumettre à Apple Podcasts

Connectez-vous à podcastsconnect.apple.com avec votre Apple ID. Cliquez "New Show", puis collez l'URL de votre flux RSS Zekast (vous la trouvez dans le tableau de bord du plugin). Apple valide votre podcast en 24 à 72 heures.

5.2Soumettre à Spotify

Allez sur podcasters.spotify.com, cliquez "Get started" puis "I have a podcast on a different hosting service", et collez l'URL de votre flux Zekast. Spotify vous envoie un code de vérification à l'adresse email associée au flux pour confirmer que vous en êtes le propriétaire.

5.3Amazon, YouTube Music, Pocket Casts

Dans le tableau de bord du plugin → Distribution, vous trouvez l'URL et la page de soumission de chaque plateforme, avec le suivi du statut en direct. YouTube Music passe par YouTube Studio. Pocket Casts ajoute automatiquement votre podcast dès qu'Apple Podcasts l'a validé.

5.4Valider votre flux RSS

Avant toute soumission, vérifiez votre flux sur podba.se/validate ou castfeedvalidator.com. Si aucune erreur ne s'affiche, vous êtes prêt à soumettre.

§06 · Migration

6.1Depuis Acast

6.2Depuis Ausha

6.3Depuis Audiomeans

6.4Depuis Anchor, Podigee, Buzzsprout, Castos

6.5Redirection et préservation de votre audience

La procédure générale, valable pour n'importe quel hébergeur de départ :

1. Récupérez l'URL de votre flux RSS actuel (vous la trouvez dans Apple Podcasts Connect, ou dans les réglages de votre hébergeur).
2. Importez dans Zekast : dans l'admin WordPress, allez dans Zekast → Importer, collez l'URL. Le plugin récupère les épisodes, métadonnées et fichiers audio. Comptez environ 30 minutes pour 50 épisodes.
3. Vérifiez votre nouveau flux Zekast : l'URL est affichée dans le tableau de bord du plugin.
4. Modifiez l'URL du flux dans Apple Podcasts Connect (option "Change Feed URL"). Apple redirige vos abonnés automatiquement, ils n'ont rien à faire — ils continuent de recevoir vos nouveaux épisodes sans avoir à se réabonner.
5. Faites pareil sur Spotify via le formulaire de migration de Spotify for Podcasters.
6. Mettez en place des redirections si vos anciennes pages d'épisode étaient publiques sur le web (un plugin WordPress comme Redirection s'en charge). Vous préservez ainsi votre référencement Google.
7. Résiliez votre ancien hébergeur quand vous voyez les écoutes basculer vers Zekast (généralement deux semaines après le changement d'URL dans Apple).

§07 · Expérience d'écoute (PWA)

Zekast transforme votre site en application web installable (PWA) pour vos auditeurs. Disponible sur les plans Pro et Studio.

7.1Installer le site comme une app

Sur mobile : vos auditeurs ouvrent votre site dans Safari (iOS) ou Chrome (Android), tapent « Partager » → « Sur l'écran d'accueil » (iOS) ou voient apparaître une bannière « Installer » (Android). Sur ordinateur, Chrome et Edge affichent une icône d'installation dans la barre d'adresse.

Une fois installée, l'app s'ouvre dans sa propre fenêtre, sans barre d'adresse, avec votre icône et vos couleurs (configurables dans Zekast → Réglages → PWA).

7.2Écoute hors connexion

Vos auditeurs peuvent télécharger un épisode pour l'écouter sans réseau. Le téléchargement se fait par épisode (pas du tout-ou-rien), le fichier vit sur leur appareil, pas sur votre infrastructure.

Côté technique : Service Worker enregistré sur votre domaine, cache des fichiers audio à la demande de l'auditeur, fallback offline pour les pages déjà visitées. Aucune configuration côté admin — le PWA est actif dès qu'un visiteur arrive sur votre site si votre plan le permet.

7.3Synchronisation entre appareils

Quand un auditeur connecté (abonné premium) commence un épisode sur son téléphone, sa position de lecture est sauvegardée toutes les dix secondes côté serveur. Quand il ré-ouvre l'app sur son ordinateur, un bandeau « Reprendre à 2:34 ? » lui propose de repartir exactement où il s'est arrêté, d'un tap (s'il préfère, la lecture démarre du début).

Les téléchargements offline suivent la même logique : un épisode téléchargé sur un appareil reste sur cet appareil (pas de re-download cross-device, économie de bande passante).

7.4Personnaliser l'identité de l'app

Dans Zekast → Réglages → PWA :

• Nom de l'app (affiché sous l'icône)
• Couleur d'accent (barre de statut, splash screen)
• Icône carrée 512×512 px (PNG)
• Splash screen (généré automatiquement à partir de l'icône + couleur)

Le manifest.webmanifest est servi automatiquement par le plugin, indexé par les navigateurs, et signé par votre domaine. Aucun store, aucune validation, aucune attente.

§08 · Avancé (développeurs)

8.1REST API

Le plugin expose des routes sous le namespace zekast/v1. Les principales routes publiques :

GET   /wp-json/zekast/v1/podcasts            # liste des podcasts
GET   /wp-json/zekast/v1/chapters/{id}       # chapitres d'un épisode
GET   /wp-json/zekast/v1/transcript/{id}     # transcription d'un épisode
POST  /wp-json/zekast/v1/play-event          # comptage d'écoute

D'autres routes (studio audio, distribution, monétisation, thème, feeds personnalisés…) sont réservées à l'administration : elles servent l'interface du plugin et exigent une session WP autorisée.

8.2Filtres et actions PHP

Zekast expose de nombreux hooks pour étendre son comportement, taggés inline dans le code avec leur version d'introduction. Quelques exemples :

// Filtres
add_filter( 'zekast_bunny_signed_ttl',           $callable ); // TTL des URLs signées
add_filter( 'zekast_hero_button_palette',        $callable ); // couleurs des boutons
add_filter( 'zekast_pwa_bottom_nav_items',       $callable ); // navigation PWA
add_filter( 'zekast_auto_preload_first_episode', $callable );

// Actions
add_action( 'zekast_console_enqueue',        $callable ); // extension de la console
add_action( 'zekast_subscriber_cancelled',   $callable ); // abonné premium résilié
add_action( 'zekast_subscriber_reactivated', $callable );

8.3Custom Post Types & méta

CPT : zekast_podcast et zekast_episode. Taxonomie podcast_feed (rattachée aux épisodes). Les métadonnées d'épisode utilisent le préfixe _episode_ :

_episode_audio_url        _episode_duration        _episode_guid
_episode_image            _episode_author          _episode_description
_episode_season           _episode_number          _episode_podcast_id
_episode_transcript_url   _episode_transcript_format
_episode_chapters

§09 · Dépannage

9.1Import qui échoue

Vérifiez d'abord la validité du flux à importer sur castfeedvalidator.com. Les causes les plus courantes : une illustration trop lourde (plus de 10 Mo), une URL d'origine qui ne répond plus, ou un flux mal formé chez l'hébergeur de départ. Le détail des erreurs s'affiche dans Zekast → Outils → Import.

9.2Flux refusé par Apple Podcasts

Apple est strict sur trois points : une illustration carrée d'au moins 1400×1400 pixels en JPG ou PNG, une adresse email propriétaire valide et vérifiable, et au moins un épisode déjà publié au moment de la soumission. Faites un diagnostic sur podba.se/validate pour repérer ce qui coince.

9.3Lecteur muet sur mobile

iOS bloque toute lecture audio automatique : l'utilisateur doit toujours cliquer Play une première fois. Le lecteur Zekast respecte cette règle, c'est normal. Si le son reste coupé après ce premier clic, contactez le support — il s'agit probablement d'un problème de configuration côté hébergement audio que nous pourrons identifier rapidement.

9.4Contacter le support

E-mail : contact@zekast.studio. Réponse en 24 h ouvrées. Pour gagner deux échanges, joignez : version plugin, URL du site, export de Zekast → Outils → Diagnostic (anonymise les credentials).

§10 · Add-on Zekast Review

Zekast Review est un add-on (extension payante séparée) de revue collaborative avant publication. Inclus gratuitement dans le plan Studio ; disponible en add-on à 15 €/mois ou 144 €/an sur les autres plans. En savoir plus →

10.1Installer l'add-on

Une fois l'add-on souscrit (depuis votre compte ou la page Review), téléchargez le ZIP zekast-review dans Compte → Téléchargements, installez-le comme une extension WordPress à côté du plugin Zekast et activez-le. Il se met ensuite à jour automatiquement. Un menu Zekast → Review apparaît.

10.2Comment ça marche

• Créez un fichier de travail (l'audio à relire, distinct de l'épisode publié) et déposez des commentaires horodatés — un point ou une plage — directement sur la forme d'onde.
• Invitez des relecteurs par lien privé, avec un niveau d'accès lecture seule, commentaire ou admin — sans compte WordPress.
• Fils de discussion, @mentions, réactions, et une décision claire d'approbation. Chaque envoi crée une version ; les commentaires non résolus des versions précédentes restent visibles.
• Exportez les marqueurs vers votre logiciel de montage (Audacity, REAPER, Adobe Audition, ou CSV générique).

§11 · Add-on Zekast Clips

Zekast Clips transforme un passage d'épisode en clip vidéo sous-titré pour les réseaux. Inclus gratuitement dans les plans Pro et Studio ; disponible en add-on à 12 €/mois ou 120 €/an sur Free et Starter. En savoir plus →

11.1Installer l'add-on

Souscrivez l'add-on depuis votre compte ou la page Clips, téléchargez le ZIP zekast-clips dans Compte → Téléchargements, installez-le à côté du plugin Zekast et activez-le (mises à jour automatiques ensuite).

11.2Créer un clip

Deux accès : l'onglet « 🎬 Clips » dans la console Zekast (panneau bas de l'éditeur d'épisode) ou la page Zekast → Clips. Sélectionnez un passage sur la forme d'onde, choisissez le format (9:16, 1:1 ou 16:9) et le style (couleurs, image de fond, pochette, titre), puis lancez le rendu. La vidéo brandée — forme d'onde animée + sous-titres incrustés — est générée en quelques secondes côté serveur, puis téléchargeable.

11.3Sous-titres

Zekast transcrit automatiquement le passage et incruste des sous-titres animés mot à mot. Vous pouvez corriger le texte avant le rendu, et régler la couleur, la taille et la police. Tous vos clips sont regroupés dans la bibliothèque « Mes clips ».