Images et médias.

Apprendre DXPR BuilderGérer le siteRésoudre un problème

Faites fonctionner les téléversements et gardez les fichiers téléversés sur le site. Les images arrivent sur la page via le téléversement propre du builder, ou via la médiathèque quand le site l’utilise. La plupart des échecs viennent des réglages de médias, des permissions de fichiers, ou d’un téléversement jamais parvenu au serveur.

Le navigateur de médias manque ou s’ouvre vide

  1. Accédez à DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings) et ouvrez la section Media.
  2. Réglez Browser type sur Media Library et cliquez sur Save settings. L’option n’apparaît que quand le module Media Library du cœur est activé. Choisissez Media Library (Acquia DAM) si vous utilisez Acquia DAM.
  3. Accédez à Structure > Media types et vérifiez qu’un type de média avec le nom machine image existe (video pour les vidéos). Le builder ouvre la médiathèque sur ce type.

Note : Basic file upload affiche un simple bouton Select image qui téléverse directement depuis votre ordinateur. C’est le défaut quand Media Library n’est pas activé. Entity Browser est l’option historique ; préférez Media Library.

Le téléversement échoue avec une erreur

  • « Destination file path is not writable » ou « File could not be saved ». Le serveur web ne peut pas écrire dans le répertoire des fichiers. Rendez sites/default/files inscriptible pour l’utilisateur du serveur web, puis vérifiez Reports > Status report.
  • « Only files with the following extensions are allowed ». Le builder accepte les images GIF, JPEG, PNG, WebP, AVIF et SVG, et les vidéos WebM, Ogg et MP4. Dans la médiathèque, c’est le type de média qui décide : ajoutez l’extension sous Allowed file extensions du champ image à Structure > Media types > Image > Manage fields.
  • « exceeding the maximum file size », ou « The uploaded video is too large ». Le fichier dépasse ce que PHP accepte. Augmentez upload_max_filesize et post_max_size dans PHP, ainsi que la limite de taille du corps de votre serveur web ou proxy.
  • 403 ou 405 sur /dxpr_builder/ajax/file_upload. Un proxy ou pare-feu bloque ou redirige les requêtes POST vers ce chemin. Mettez-le sur liste d’autorisation, et assurez-vous que le site ne le redirige pas, par exemple de HTTP vers HTTPS.
  • Les contributeurs reçoivent « Access denied » dans le navigateur de médias. Le rôle a besoin de View media pour ouvrir la médiathèque, et de Image : Create new media pour y téléverser. Accordez les deux sous People > Permissions.

Les images disparaissent quelques heures après le téléversement

Le fichier a disparu de sites/default/files/dxpr_builder_images et la page affiche une image cassée.

Les versions avant 3.0.0-alpha85 enregistraient les téléversements du builder comme fichiers temporaires quand le module Media était désactivé. Le cron de Drupal supprime les fichiers temporaires après six heures.

  1. Mettez à jour vers la version actuelle. Elle enregistre les téléversements comme fichiers permanents et consigne leur usage.
  2. Téléversez à nouveau les images manquantes, ou restaurez-les depuis une sauvegarde dans le même dossier.

Note : les téléversements vont dans dxpr_builder_images, dxpr_builder_videos et dxpr_builder_files dans le répertoire de fichiers par défaut.

Les images s’affichent dans l’éditeur mais pas pour les visiteurs

  • L’image a disparu après un rechargement. Le conteneur n’a pas été enregistré. Ajoutez à nouveau l’image et cliquez sur Save sur la barre du conteneur.
  • Vous voyez l’image, pas les visiteurs. Apply text format filters to frontend content est activé sous General Settings > Text Filters, et le format de texte du champ retire les balises img ou leurs attributs. Les contributeurs voient toujours le contenu non filtré. Désactivez le réglage, ou autorisez img dans ce format de texte.
  • Les visiteurs voient une version plus ancienne de la page. Un cache sert l’ancienne page. Voir Les visiteurs voient autre chose.

Vérifier la correction

Téléversez une image dans un élément Image et enregistrez le conteneur. Dans une fenêtre privée, l’image s’affiche pour un visiteur anonyme.

Et ensuite ?

Intégration de la médiathèque pour réutiliser des médias existants dans le builder.