Créer un espace membres avec WebBlocks Memberships

Memberships relie quatre éléments faciles à confondre :

Un compte visiteur est distinct d’un compte administrateur CMS. S’inscrire comme membre ne donne pas accès au panneau d’administration. Une offre d’accès n’a pas de prix propre : la formule payante définit le prix, la fréquence de facturation et le prestataire.

Vous pouvez utiliser les comptes, les offres gratuites, les attributions manuelles et les pages protégées sans Commerce. Les abonnements payants récurrents nécessitent des prestataires Commerce compatibles. Un Commerce Buy Button vend un produit avec paiement unique ; il ne crée pas d’abonnement Memberships récurrent.

Pour les points d’accès développeur et les intégrations, consultez la référence Memberships. Ce guide suit les opérations du panneau et de l’écran de compte visiteur.

Apprenez le fonctionnement sur une installation de test. Il vous faut :

• Un site WebBlocks CMS fonctionnel et un compte Super admin pour installer le plugin.
• Une version compatible : Memberships 0.2.0 exige CMS ^1.100.0 ; le catalogue indique PHP 8.4 et Laravel 13. Comparez ces exigences à votre installation.
• L’autorisation de gérer Memberships et de modifier les pages du site choisi. Le plugin fournit une permission Site Admin ; l’affectation des sites à l’utilisateur reste applicable.
• Un domaine canonique du site correct et un courrier sortant CMS opérationnel pour la vérification et la réinitialisation des mots de passe.
• Pour les futures formules payantes : Commerce ^0.16, PayPal ou SumUp configuré, une adresse de rappel HTTPS publique et le planificateur Laravel opérationnel.

Demandez à l’administrateur de l’hébergement de vérifier la livraison vers une boîte de test avant d’inviter des membres. L’environnement local des captures utilise des comptes fictifs ; il ne démontre pas la réception dans une véritable boîte.

Memberships est indiqué comme gratuit dans le catalogue des plugins. Les comptes marchands et le traitement des paiements sont des services distincts.

1. Connectez-vous comme Super admin et ouvrez System → Plugins.
2. Sélectionnez Browse Plugin Catalog, puis Memberships.
3. Vérifiez la compatibilité et la version choisie, puis sélectionnez Install from Catalog.
4. Ouvrez les détails du plugin installé et choisissez Enable Plugin. Les nouveaux paquets sont d’abord désactivés pour permettre leur examen.
5. Contrôlez l’état du plugin et le résultat de la préparation de la base avant d’inviter des visiteurs.

Si l’administrateur fournit une archive ZIP de confiance, utilisez Plugin ZIP → Upload Plugin ZIP, vérifiez-la et activez le plugin. L’installation depuis le panneau ne demande pas au propriétaire de compiler les sources.

Les versions actuelles du CMS appliquent les modifications de base du plugin à l’installation, à la mise à jour et à l’activation. Si cette préparation échoue, corrigez l’erreur avant de continuer. Un avertissement de courrier ou de prestataire concerne la disponibilité du service, pas l’absence de tables.

Ouvrez Memberships dans la barre latérale. Vérifiez le nom du site en haut. Dans la version 0.2.0, l’URL de gestion accepte ?site_id=... ; sans site indiqué, le panneau choisit le premier autorisé. Sur une installation multisite, faites ouvrir la bonne URL de gestion et contrôlez le titre avant de modifier offres, comptes ou accès. Cette version ne comporte pas de sélecteur de site dans le formulaire Memberships.

Une offre regroupe des droits d’accès. Commencez par une offre gratuite pour tester comptes et accès aux pages sans prestataire de paiement.

Dans Memberships, passez les offres existantes et descendez jusqu’au formulaire Packages vide :

1. Saisissez Studio community dans Name.
2. Saisissez Free access to the Northstar Studio member reading room. dans Description.
3. Cochez Allow free self enrollment.
4. Sélectionnez le bouton Save de ce formulaire.

L’offre est active dès sa création. Son formulaire enregistré montre Package ID, Active et Allow free self enrollment. Conservez l’identifiant pour la suite.

Seules les offres actives autorisant l’adhésion gratuite apparaissent aux visiteurs. Un visiteur vérifié peut les rejoindre sans approbation d’un opérateur ni paiement. L’adhésion gratuite crée un droit sans date de fin.

Créez une deuxième offre Workshop circle, avec la description Workshop resources for invited participants. Laissez Allow free self enrollment décoché. Vous l’attribuerez manuellement à l’étape 7 ou la relierez ensuite à une formule payante.

Laissez l’adhésion gratuite désactivée pour une offre qui doit exiger un paiement ou une invitation. Sinon, un visiteur vérifié peut obtenir le même accès gratuitement. Une formule payante séparée n’annule pas une attribution gratuite disponible.

Vous pouvez créer un lien direct vers /plugins/webblocks-memberships/account ou utiliser les blocs natifs sur une page CMS ordinaire.

Créez un brouillon Join Northstar Studio, ou préparez une mise à jour en révision d’une page d’adhésion existante. Utilisez le même site que les offres. Ajoutez un titre et une courte explication des avantages, puis :

1. Dans le slot Main de la page, sélectionnez Add Block.
2. Choisissez My membership account, le bloc de compte natif de Memberships.
3. Enregistrez le bloc.
4. Ajoutez éventuellement Available free packages, le bloc natif de liste des offres.
5. Affichez l’aperçu de la page.

Le bloc affiche un lien My membership account. Inscription, connexion, réinitialisation du mot de passe et gestion du compte se déroulent sur une page distincte. Il n’intègre pas de formulaire d’inscription dans votre page éditoriale.

La liste affiche les offres actives permettant l’adhésion gratuite avec des liens Join free package. Le visiteur doit toujours se connecter et vérifier son e-mail pour adhérer. Pour un lien permanent dans l’en-tête, ajoutez une entrée Member account vers la route du compte ; voir Menus de navigation.

Vérifiez l’aperçu et publiez la page seulement quand textes, liens et courrier d’inscription sont prêts. L’aperçu éditorial n’isole pas les actions de compte : inscription, adhésion et requêtes de facturation utilisent les véritables données membres de l’installation.

Ouvrez le lien du compte dans un autre profil de navigateur ou une fenêtre privée. Vous distinguerez plus facilement la session du visiteur de celle de l’administrateur.

Le premier formulaire demande Name et Email. Il ne demande volontairement pas de choisir un mot de passe avant d’avoir prouvé le contrôle de la boîte.

1. Dans Create account, saisissez un nom de test et une adresse que vous contrôlez.
2. Sélectionnez Create account.
3. Ouvrez l’e-mail de vérification du domaine canonique de ce même site.
4. Suivez le lien, renseignez Password et Confirm password, puis choisissez Continue.
5. Revenez à Sign in et connectez-vous avec cette adresse et ce mot de passe.

Les liens de vérification expirent après 24 heures. Les ouvrir affiche un formulaire ; le soumettre termine la vérification et définit le mot de passe. Afficher le lien seul ne le consomme pas.

Si le message n’arrive pas, vérifiez les indésirables, le courrier sortant CMS et le domaine canonique. Utilisez le renvoi lorsqu’il est proposé dans le parcours. Pour un compte en attente, Request password reset émet un lien de vérification au lieu de contourner le contrôle de la boîte. Ne créez pas un deuxième compte pour résoudre un problème de courrier.

Un visiteur connecté mais non vérifié ne peut ni rejoindre une offre ni ouvrir les contenus membres. La vérification et l’état actif du compte sont nécessaires. Une réinitialisation du mot de passe invalide les sessions précédentes.

Après connexion, My membership account affiche le nom et l’e-mail du visiteur, un champ de nom de profil, les adhésions, les abonnements et les offres disponibles.

Notre compte fictif possède déjà une attribution datée Workshop circle pour illustrer le parcours opérateur de l’étape 7. Un visiteur nouvellement inscrit n’a initialement aucune adhésion.

Dans Available free packages, trouvez Studio community et sélectionnez Join free package. La liste montre désormais Studio community, son début, No expiry et Active.

Cette action inscrit le visiteur à l’offre gratuite ; elle ne crée ni autorisation de paiement ni abonnement payant. L’adhésion gratuite ne permet pas de prolonger ou remplacer une attribution opérateur existante. Si une ancienne attribution a expiré ou a été révoquée, demandez à l’opérateur de la vérifier et de la prolonger plutôt que de cliquer sur Join à répétition.

Créez une page Studio reading room sur le même site. Ajoutez et examinez les contenus membres avant de changer l’accès. Retenez le titre pour la retrouver dans le formulaire Memberships.

Ouvrez Memberships, descendez à Page access, puis :

1. Choisissez Studio reading room dans Page.
2. Choisissez Package holders dans Access.
3. Choisissez Studio community dans Package ID.
4. Sélectionnez le bouton Save de ce formulaire.

Trois options sont disponibles :

Ce formulaire peut exiger une seule offre sélectionnée par page. La même offre peut provenir d’une attribution manuelle ou d’une période payée vérifiée : ces sources d’accès sont indépendantes.

Si la salle est un brouillon, publiez-la après avoir contrôlé la règle. Page access change immédiatement la politique d’accès, indépendamment du brouillon de contenu ou de la mise à jour en révision. Ne supposez pas que l’enregistrement de la règle attend une publication ultérieure. Revérifiez la page publique et utilisez un site de test pendant l’apprentissage.

Testez l’URL directe avec deux sessions visiteur :

• Déconnecté : le contenu de la salle doit rester inaccessible.
• Connecté comme membre vérifié Studio community : la page doit s’ouvrir.

Utilisez la route visiteur, pas l’aperçu administrateur. Testez aussi un compte vérifié sans l’offre requise si vous en avez un : la vérification seule ne doit pas ouvrir une page protégée par offre.

Les pages protégées sont exclues de la recherche publique, du sitemap et de la navigation automatique. Donnez aux membres un lien explicite, par exemple dans les instructions d’adhésion, au lieu d’attendre qu’une liste automatique annonce la salle.

La protection reste active si Memberships devient indisponible. Restaurer une ancienne révision du contenu ne supprime pas la règle actuelle. Les copies héritent des restrictions ; les droits d’offre entre sites nécessitent une réaffectation explicite. Une restauration de contenu ou une désactivation du plugin ne rend pas la page publique. Pour la rouvrir volontairement, choisissez Public dans Page access et enregistrez.

Utilisez une attribution manuelle pour une invitation, un accord hors site ou un droit d’atelier à durée définie.

Trouvez Member ID dans la table Members et Package ID au-dessus du formulaire Workshop circle enregistré. Ces identifiants désignent les enregistrements du site choisi ; ce ne sont ni mots de passe ni codes d’invitation.

Descendez à Grant or extend membership et saisissez :

Sélectionnez Save. L’attribution apparaît sous Membership grants et dans le compte du membre.

Le panneau indique ces dates en UTC. Convertissez le début et la fin depuis le fuseau local du site avant de les saisir. Le compte visiteur affiche les dates dans le fuseau configuré du site. Un début futur n’est pas encore actif ; une fin égale ou antérieure à maintenant a expiré. Laissez Ends at UTC vide seulement pour une adhésion volontairement sans fin.

Pour prolonger la même attribution membre/offre, saisissez à nouveau les mêmes identifiants avec la période complète souhaitée et enregistrez. L’attribution est mise à jour, pas dupliquée. Cela supprime aussi une ancienne révocation : vérifiez donc toute la période avant d’enregistrer.

Pour un test durable, choisissez des dates couvrant le jour du test ; les dates fixes des captures sont des exemples, pas des valeurs à réutiliser indéfiniment.

Revoke dans Membership grants retire le droit de cette attribution manuelle. Cela n’annule pas un abonnement payant distinct ; le membre peut conserver le même accès grâce à un autre droit actuel. Examinez attributions et paiements lorsque vous recherchez la cause d’un accès.

Disable account dans Members empêche le compte de se connecter ou d’utiliser ses sessions existantes. Cela demande aussi l’annulation des renouvellements de ce membre. Réactiver le compte exige une nouvelle connexion ; ce n’est pas une nouvelle autorisation de paiement.

Décocher Active sur une offre la rend indisponible pour l’accès et demande l’annulation des renouvellements de ses abonnements. C’est un changement d’accès et de facturation, pas seulement le masquage d’une carte.

Pour les adhésions payantes, suivez aussi les vérifications de l’étape 11. Une annulation en attente nécessite encore la confirmation du prestataire ; désactiver des données locales ne prouve pas la fin d’un accord externe.

Terminez d’abord le parcours gratuit. Pour les offres payantes, configurez avec l’administrateur Commerce 0.16.x et son prestataire PayPal ou SumUp. Memberships réutilise ces paramètres ; il ne possède pas de deuxième formulaire d’identifiants.

Le guide Commerce explique installation et configuration. Test order (no payment) sert aux commandes uniques Commerce ; il ne produit ni paiements Memberships récurrents vérifiés ni accès payant.

Avant de proposer une formule :

1. Configurez le prestataire prévu dans Commerce → Settings, en commençant par son sandbox et le compte marchand de test correspondant.
2. Vérifiez identifiants, devise compatible et disponibilité.
3. Définissez un domaine canonique HTTPS publiquement accessible pour le site membres.
4. Vérifiez les rappels. PayPal utilise le webhook Commerce existant avec les événements d’abonnement et de vente ; SumUp utilise le rappel de facturation Memberships.
5. Faites exécuter le planificateur Laravel de l’application hôte chaque minute et vérifier son signal d’activité par l’administrateur.
6. Confirmez que l’offre est active et Allow free self enrollment désactivé si un paiement est requis.

Memberships enregistre webblocks-memberships:billing:sync toutes les cinq minutes. PayPal effectue ses propres prélèvements de renouvellement ; la tâche locale rapproche les preuves du prestataire et l’accès. Pour SumUp, elle traite aussi les renouvellements autorisés arrivés à échéance. L’administrateur peut exécuter la commande pour enquêter, mais doit savoir qu’elle peut déclencher les débits SumUp autorisés dus. Ce n’est pas une commande de diagnostic limitée à l’aperçu.

Le webhook PayPal est /plugins/webblocks-commerce/webhooks/paypal. Ajoutez les événements pertinents BILLING.SUBSCRIPTION.* et PAYMENT.SALE.* à l’abonnement webhook de l’application PayPal. Le rappel récurrent SumUp est /plugins/webblocks-memberships/billing/webhooks/sumup, distinct du rappel Commerce des commandes uniques. Utilisez l’hôte canonique HTTPS, pas le localhost des captures.

Consultez la documentation actuelle PayPal Subscriptions et le guide SumUp des cartes enregistrées pour les exigences de compte. Un paiement unique réussi ne prouve pas que ce marchand prend en charge la facturation récurrente.

Dans Memberships → Paid plans, remplissez le formulaire :

Amount in minor units est un entier. Pour une formule à €10, saisissez 1000, pas 10 ni 10.00. La précision dépend de la devise ; toutes n’utilisent pas des centimes. Les intervalles mensuels acceptent 1–12. Une formule annuelle utilise year(s) avec 1.

Choisissez Save seulement quand le prestataire est configuré. Contrôlez le montant affiché et l’offre associée à la formule enregistrée. La capture montre le formulaire avant soumission, sans identifiants marchands configurés ; elle ne prouve pas une connexion fonctionnelle.

Les abonnements existants conservent le tarif et la cadence convenus. Créez une nouvelle formule pour changer de prix. Ne supposez pas qu’une formule de remplacement modifie silencieusement les autorisations existantes.

Sur la page du compte, un membre vérifié trouve Paid plans, choisit un Payment provider disponible et coche le consentement explicite :

I authorize the stated recurring subscription charge until I cancel renewal.

Il sélectionne ensuite Subscribe. Le prestataire doit être activé dans la formule et disponible. Une liste vide ou un bouton Subscribe désactivé signale un problème de préparation à résoudre, pas une raison d’activer l’adhésion gratuite.

PayPal : le membre suit Approve with PayPal et approuve l’accord récurrent chez PayPal. Le retour sur le site n’est pas une preuve de paiement. Utilisez Check payment status et vérifiez que le serveur confirme une période payée avant d’attendre l’accès à l’offre.

SumUp : le membre complète le widget carte et l’authentification nécessaire aux paiements récurrents avec carte enregistrée. Le débit temporaire de configuration de 1 unité est remboursé ; en EUR, cela représente €1.00. Cette configuration ne paie pas l’abonnement à €10 et n’ouvre pas l’accès. Seul un paiement d’abonnement vérifié le permet. Les données brutes de carte vont dans le widget du prestataire, jamais dans un bloc CMS ordinaire.

Le membre peut ouvrir Manage subscription dans son compte. Les opérateurs voient Subscriptions sous Paid plans, avec Check payment status, Cancel renewal et l’historique des paiements.

Testez l’annulation dans le sandbox avant de proposer des formules réelles. Choisissez Cancel renewal, puis Check payment status jusqu’à confirmation de l’annulation externe. La demande arrête les futures demandes de renouvellement, mais un paiement déjà demandé peut encore aboutir. L’accès reste normalement valable jusqu’à la fin de la période payée, sauf périodes remboursées ou annulées.

Stop offering this plan and cancel renewal concerne toute la formule et demande l’annulation de ses abonnements. Ce bouton ne sert ni à modifier le tarif ni à masquer l’offre tout en conservant tous les renouvellements.

Une période SumUp entièrement manquée impose une nouvelle adhésion plutôt qu’un rattrapage automatique des périodes expirées. Si le résultat d’un paiement est inconnu, n’envoyez pas continuellement de nouveaux abonnements : rapprochez d’abord la référence existante. Les attributions manuelles restent indépendantes ; les révoquer n’annule pas la facturation, et annuler la facturation ne supprime pas une attribution valide.

Annulez les accords externes et confirmez le résultat avant de supprimer définitivement Memberships, Commerce ou la configuration du prestataire. Supprimer le code local n’annule pas à lui seul un accord PayPal natif.

Passez aux paramètres réels seulement quand le sandbox du marchand a validé approbation, confirmation de paiement, renouvellement, annulation et rappels. Ces contrôles exigent votre propre compte de test ; les captures fictives ne les remplacent pas.

Une page protégée ne rend pas privée une URL de fichier déjà publique. Ne déposez pas de document confidentiel dans le stockage public en supposant que masquer la page le protège.

Demandez à l’administrateur de préparer un disque de système de fichiers privé, non public. Une entrée privée de la médiathèque utilisée par un bloc publié sur une page protégée peut être servie par la route privée Memberships avec le même contrôle page/offre.

La route est /plugins/webblocks-memberships/downloads/{page}/{media}. Utilisez les vrais identifiants de page et de média et vérifiez le lien avec le bloc publié. Modifier seulement le drapeau de confidentialité du média n’annule pas une URL de stockage publique. Testez le téléchargement déconnecté puis comme titulaire de l’offre.

Pour les téléchargements publics ordinaires, consultez Proposer un fichier téléchargeable. Faites examiner le stockage confidentiel avant de réutiliser ce parcours pour des ressources membres.

Appointments peut utiliser Memberships en option pour reconnaître un visiteur connecté, préremplir ses coordonnées et associer une réservation au membre vérifié. Un service peut exiger un compte vérifié ou une offre active précise.

Choisissez le même site et l’offre prévue pour configurer un service réservé. Le droit d’accès payé utilise la même vérification que l’attribution manuelle. Inutile de vendre un autre produit Commerce pour dupliquer l’adhésion.

Les réservations ordinaires sans compte restent possibles sans Memberships. Les services réservés restent indisponibles si le service membres requis ne l’est pas. Modifier l’accès ne réécrit pas les données clients historiques des rendez-vous passés. Consultez la référence Appointments pour sa configuration distincte.

Vérifiez que la page explique l’offre, que les liens ouvrent le bon site, que le courrier arrive et qu’un visiteur vérifié peut rejoindre l’offre gratuite prévue. Testez la page protégée déconnecté, sans offre puis avec un droit actuel. Contrôlez les dates UTC et l’absence d’adhésion gratuite sur les offres exclusivement payantes.

Si vous proposez des paiements récurrents, vérifiez aussi sandbox, rappels, planificateur, accès à la période actuelle et annulation confirmée. Publiez uniquement les pages examinées et répétez les contrôles directs de visiteur et de téléchargement sur le site HTTPS public.

Poursuivez avec la référence Memberships, le guide Commerce, Menus de navigation ou Rôles et permissions.