Placer le portail sur une page

Pour afficher le portail sur votre site, créez une page et ajoutez le shortcode [nopd_dropbox_portal]. Un shortcode est un petit code entre crochets que WordPress remplace par le portail quand la page s’affiche.

Ajouter le shortcode à une page

1. Dans l’administration de WordPress, allez dans Pages > Ajouter une page (ou ouvrez une page existante).
2. Donnez un titre à la page, par exemple « Espace réservé ».
3. Dans l’éditeur de blocs, cliquez sur le bouton + et ajoutez un bloc Code court.
4. Saisissez ou collez [nopd_dropbox_portal] dedans. Vous pouvez le copier depuis le cadre Put the portal on a page en bas de la page Dropbox Documents, avec le bouton Copy.
5. Cliquez sur Publier.

Si vous utilisez un constructeur de pages (Elementor, Divi et autres), utilisez son propre élément « Shortcode » ou « Texte » et collez-y le même code.

Ouvrez la page en étant connecté avec un utilisateur qui a accès : vous voyez la liste des dossiers. Les visiteurs non connectés voient « You need to sign in to view the private documents. » (vous devez vous connecter pour voir les documents privés). L’extension n’ajoute pas de formulaire de connexion : ajoutez à la page votre lien ou formulaire de connexion habituel, ou utilisez votre extension d’adhésion.

Attributs

Les attributs sont des réglages facultatifs que vous écrivez entre les crochets, comme view="grid".

Attribut	Valeurs	Ce qu’il fait
root	Un ID de règle, par exemple 3	Affiche uniquement le dossier de cette règle (la colonne ID de l’étape 3). S’il est absent, le portail affiche tous les dossiers auxquels l’utilisateur a accès. Les utilisateurs qui n’ont pas accès à cette règle voient le message « aucun dossier ».
view	list (par défaut) ou grid	Mode d’affichage des fichiers. La grille est Pro : sans licence, le portail revient à la liste. Avec Pro, les visiteurs peuvent aussi changer d’affichage avec les boutons en haut du portail.
theme	light (par défaut), dark ou auto	Thème de couleurs. auto suit le réglage clair ou sombre du visiteur. Sombre et auto sont Pro : sans licence, le portail reste clair.
title	N’importe quel texte	Titre affiché dans la barre colorée en haut du portail.
subtitle	N’importe quel texte	Ligne de texte sous le titre.
height	Une taille, par exemple 600px	Hauteur maximale de la liste des fichiers. La liste défile alors à l’intérieur du portail et les en-têtes de colonnes restent visibles.

Exemples

Un portail simple avec un titre :

[nopd_dropbox_portal title="Project documents"]

Uniquement le dossier de la règle 2, en grille, avec une hauteur fixe :

[nopd_dropbox_portal root="2" view="grid" height="620px"]

Tout ensemble :

[nopd_dropbox_portal view="grid" theme="auto" title="Project documents" subtitle="Updated from Dropbox" height="620px"]

Si votre thème a un en-tête fixe

Certains thèmes gardent l’en-tête du site en haut de la page pendant le défilement, et il peut masquer le haut du portail. Ajoutez un height, par exemple height="620px" : seule la liste des fichiers défile, et la barre d’outils du portail reste visible.

Cache des pages

Le portail affiche un contenu différent à chaque utilisateur : la page ne doit donc jamais être mise en cache. L’extension demande aux extensions de cache courantes de ne pas la mettre en cache. Si vous utilisez un cache au niveau du serveur, d’un proxy ou d’un CDN (par exemple des règles de page Cloudflare ou le cache de l’hébergeur), excluez-y aussi la page du portail.