WordPress Studio : questions fréquemment posées

Sur cette page, vous trouverez des réponses aux questions fréquentes concernant l’application WordPress Studio et certaines fonctionnalités comme l’Assistant Studio et Studio Sync.

Pour rappel, WordPress Studio est un projet open source qui accueille toutes les contributions. Si vous repérez un bug ou si la fonctionnalité Studio dont vous avez besoin est absente, plusieurs options s’offrent à vous :

• Contactez nos Happiness Engineers pour toute question spécifique sur l’utilisation de Studio.
• Ouvrez un ticket dans le dépôt pour signaler des bugs, suggérer des idées ou demander de nouvelles fonctionnalités.

FAQ générales

Voici quelques réponses aux questions fréquentes sur WordPress Studio :

Comment puis-je exporter un thème créé dans WordPress Studio ?

Les thèmes créés dans Studio sont identiques aux thèmes créés sur des sites WordPress traditionnels. Vous pouvez exporter votre thème en suivant ces étapes :

1. Sélectionnez le site local dans Studio.
2. Assurez-vous que votre site est déjà en cours d’exécution.
3. Cliquez sur l’onglet Vue d’ensemble.
4. Cliquez sur le bouton « Éditeur de site ».
5. Une fois l’éditeur de site chargé dans votre navigateur, développez l’éditeur en cliquant n’importe où sur l’aperçu du site.
6. Cliquez sur le bouton du menu Options en haut à droite de l’écran, représenté par l’icône des points de suspension (⋮).
7. Cliquez sur Exporter, et votre navigateur devrait commencer à télécharger un fichier .zip de votre thème.

Vous pouvez ensuite téléverser votre thème sur n’importe quel site WordPress en production ou de préproduction en suivant ces instructions.

Comment puis-je publier mon site Studio pour qu’il soit accessible publiquement ?

Bien que les sites de prévisualisation soient conçus pour être partagés avec des clients et recueillir des retours préliminaires pendant une durée maximale de sept jours, un plan d’hébergement est nécessaire pour rendre votre site accessible de manière permanente.

Pour publier votre site local sur WordPress.com, suivez les étapes décrites dans la documentation Studio Sync.

Pour publier votre site local sur un autre hébergeur WordPress, suivez le guide Exportation et importation pour créer une exportation de votre site source. Lorsque l’exportation est prête, vous pouvez importer ce contenu sur le site de destination, par exemple en suivant le guide Restaurer manuellement votre site à partir d’un fichier Jetpack Backup sur WordPress.com.

Comment puis-je gérer la base de données SQLite du site Studio ?

WordPress Studio utilise SQLite au lieu d’un serveur MySQL. SQLite est un moteur de base de données SQL léger et autonome qui stocke votre base de données dans un seul fichier. Chacun de vos sites dispose d’un fichier de base de données accessible au chemin suivant : wp-content/database/.ht.sqlite. Il s’agit d’un fichier caché qui peut ne pas être visible dans votre explorateur de fichiers. Sur Mac, vous pouvez appuyer sur cmd + shift + . pour afficher les fichiers cachés dans le Finder.

Une fois que vous avez localisé le fichier de base de données SQLite, vous pouvez gérer la base de données à l’aide de n’importe quelle application compatible avec SQLite. Si vous êtes à l’aise avec la ligne de commande, nous recommandons l’outil en ligne de commande SQLite3. Sinon, vous pouvez utiliser une application graphique comme SQLiteStudio, qui offre une interface conviviale pour travailler avec la base de données.

SQLite3

SQLite est installé par défaut sur les systèmes Unix comme Mac. Pour Windows, vous pouvez le télécharger depuis la page officielle.

Une fois l’installation effectuée :

1. Sélectionnez le site local dans Studio.
2. Cliquez sur l’onglet Vue d’ensemble.
3. Cliquez sur le bouton Terminal.
4. Dans votre terminal, exécutez la commande suivante pour interagir avec votre base de données :
   sqlite3 wp-content/database/.ht.sqlite

Apprenez-en davantage sur l’utilisation de SQLite3 depuis le terminal dans la documentation SQLite3.

SQLiteStudio

Si vous préférez utiliser une application avec une interface graphique, vous pouvez utiliser SQLiteStudio.

Une fois l’application installée :

1. Trouvez le dossier wp-content/database/ dans l’Explorateur de fichiers ou le Finder.
2. Assurez-vous que les fichiers cachés sont visibles.
3. Ouvrez SQLiteStudio.
4. Faites glisser-déposer le fichier .ht.sqlite dans l’application.

Comment puis-je utiliser Studio avec le serveur MySQL de mon choix ?

WordPress Studio intègre nativement la prise en charge d’une base de données SQLite, mais vous pouvez utiliser le serveur MySQL de votre choix, par exemple Homebrew ou Docker, pour tester votre site avec différents moteurs de base de données.

Si vous avez déjà configuré un site local pour qu’il fonctionne avec un serveur MySQL personnalisé, vous pouvez l’ajouter à Studio. Si les fichiers du site incluent un fichier wp-config.php, Studio ignorera la configuration de la base de données SQLite et utilisera la base de données déjà configurée.

Si vous avez déjà créé un site dans Studio et souhaitez remplacer SQLite par le serveur MySQL de votre choix, suivez les étapes ci-dessous :

1. Arrêtez le site.
2. Ouvrez le répertoire du site dans Studio.
3. Accédez au répertoire wp-content et supprimez le fichier db.php ainsi que le répertoire database.
4. Accédez au répertoire mu-plugins et supprimez le répertoire sqlite-database-integration-main.
5. Mettez à jour le fichier wp-config.php et renseignez les identifiants de votre serveur MySQL.
6. Démarrez le site.
7. Démarrez votre serveur MySQL.
8. Ouvrez le site.

Comment sélectionner les versions de PHP et de WordPress pour mon site ?

Vous pouvez sélectionner la version de PHP ou de WordPress pour votre site lors de sa création. Cette option se trouve dans la section « Réglages avancés ». Après la création d’un site, les versions actuelles de PHP et de WordPress sont affichées dans l’onglet Réglages du site, où vous pouvez également les modifier.

1. Sélectionnez le site concerné dans la barre latérale.
2. Cliquez sur l’onglet Réglages.
3. Cliquez sur le bouton Modifier dans le coin supérieur droit.
4. Dans la boîte de dialogue, sélectionnez les versions de PHP et de WordPress souhaitées.
5. Cliquez sur le bouton Enregistrer pour enregistrer les modifications.

Pourquoi le bouton « Ouvrir dans » n’est-il pas disponible pour mon application préférée ?

Pour chacun de vos sites locaux, les options « Ouvrir dans… » suivantes sont disponibles :

Explorateurs de fichiers :

• Finder (pour macOS)
• Explorateur de fichiers (pour Windows)

Éditeurs de code :

• VS Code
• PhpStorm
• Windsurf
• WebStorm
• Cursor

Applications de terminal :

• Terminal (pour macOS)
• iTerm (pour macOS)
• Warp (pour macOS)
• Invite de commandes (pour Windows)
• Ghostty

WordPress Studio, les éditeurs de code et les applications de terminal doivent se trouver dans votre dossier Applications pour que les options Ouvrir dans… soient disponibles.  Si vous n’avez pas sélectionné d’éditeur de code préféré dans vos réglages utilisateur, aucun bouton d’éditeur de code n’apparaîtra dans la zone Ouvrir dans…. De même, si aucune application de terminal n’est sélectionnée, l’application par défaut sera :

• Terminal sur macOS
• Invite de commandes sur Windows

Comment puis-je rendre Studio plus rapide sur Windows ?

Si le service de protection en temps réel de Windows Defender est activé sur votre machine, il peut ralentir le processus de création et de démarrage d’un site, en particulier lors de l’exécution des fichiers PHP de WordPress.

C’est pourquoi WordPress Studio vous invite à « accélérer la création de site » lorsque vous créez votre premier site, afin qu’une politique d’exclusion puisse être ajoutée au service de protection en temps réel.

Vous pouvez ajouter cette politique d’exclusion manuellement en accédant à Aide -> Vous souhaitez accélérer la création de site ? dans Studio.

Comment puis-je régénérer mes miniatures ?

Si certaines miniatures sont manquantes après l’importation de votre site, vous pouvez les régénérer en commençant par installer la CLI Studio, puis en exécutant la commande CLI suivante :

studio wp media regenerate --yes --only-missing

Comment accéder aux journaux de Studio ?

Parfois, des actions comme Pousser ou Tirer dans l’onglet Synchronisation, ou l’importation et l’exportation, peuvent échouer pour différentes raisons liées à PHP, à la base de données du site ou à un problème de code personnalisé.

Si cela se produit, WordPress Studio vous permettra d’ouvrir les journaux et pourra vous demander de contacter le support. Vous pouvez également ouvrir les journaux manuellement.

Si vous utilisez Studio sur Mac :

1. Ouvrez Terminal.
2. Entrez la commande :
   open ~/Library/Logs/Studio
3. Localisez le fichier journal le plus récent et ouvrez-le.

Si vous utilisez Studio sur Windows :

1. Ouvrez le Terminal.
2. Entrez la commande :
   ii AppDataRoamingStudiologs
3. Localisez le fichier journal le plus récent et ouvrez-le.

Est-il possible de modifier le port ou l’URL de mon site Studio ?

Par défaut, les sites Studio se voient attribuer un port unique à partir de 8881. Par exemple, votre premier site Studio utilise l’URL http://localhost:8881, et votre deuxième site utilise http://localhost:8882. Bien que le port des URL localhost ne puisse pas être modifié depuis Studio, vous pouvez toujours utiliser un domaine personnalisé au lieu de localhost.

Comment utiliser un outil de tunneling (ngrok) avec Studio ?

Vous pouvez utiliser WordPress Studio pour le développement local de WordPress nécessitant des connexions entrantes en configurant un outil de tunneling comme ngrok. ngrok, qui est gratuit, redirige les requêtes externes vers votre localhost, ce qui rend votre site accessible depuis Internet. Cela est particulièrement utile pour les extensions comme Jetpack, qui passent par défaut en mode hors ligne lorsqu’elles fonctionnent en local. En utilisant un outil de tunneling, votre site local peut se reconnecter à WordPress.com, ce qui débloque toutes les fonctionnalités de Jetpack et crée un environnement de développement plus réaliste.

Suivez les étapes ci-dessous pour configurer votre site pour ce flux de travail. Commencez par démarrer votre site Studio local et configurer l’outil de tunneling.

Si votre site utilise un domaine local sous la forme localhost:port :

1. Démarrez votre site Studio et notez son port (par ex., 8883). Le port se trouve également dans l’onglet Réglages.
2. Ouvrez un terminal et configurez ngrok si ce n’est pas déjà fait.
3. Configurez un tunnel pour exposer votre site local à l’aide de la commande suivante :
   ngrok http 8883

 Si votre site utilise un domaine local personnalisé :

1. Démarrez votre site Studio et notez le domaine (par ex., my-wordpress-website.wp.local). Le domaine se trouve également dans l’onglet Réglages.
2. Ouvrez un terminal et configurez ngrok si ce n’est pas déjà fait.
3. Configurez un tunnel pour exposer votre site local à l’aide de la commande suivante :
   ngrok http --host-header=my-wordpress-website.wp.local http://my-wordpress-website.wp.local

Lorsque votre tunnel est actif, veillez à noter l’URL du tunnel et à la mettre à jour dans le fichier de configuration WordPress de votre site Studio.

1. Copiez l’URL du tunnel générée. Elle ressemblera à ceci :
   https://6xb2-12-13-14-15.ngrok-free.app
2. Mettez à jour votre configuration WordPress (wp-config.php) en ajoutant :
   define( 'WP_SITEURL', 'https://6xb2-12-13-14-15.ngrok-free.app' );
define( 'WP_HOME', 'https://6xb2-12-13-14-15.ngrok-free.app’ );
3. Actualisez votre site dans le navigateur.

Votre site Studio local devrait maintenant être accessible via l’URL du tunnel. Si la redirection ne se fait pas automatiquement, videz le cache de votre navigateur. Vous pouvez également accéder au site directement en utilisant l’URL du tunnel générée. 

L’URL locale affichée dans l’onglet Réglages ne sera pas mise à jour pour refléter la nouvelle URL du tunnel, et comme l’URL ngrok change à chaque redémarrage du tunnel, vous devrez mettre à jour le fichier wp-config.php en conséquence.

Pour réinitialiser votre site local, arrêtez le tunnel dans le terminal et arrêtez le site Studio. Ensuite, supprimez les modifications apportées à wp-config.php et redémarrez votre site Studio. Il reviendra alors à localhost ou au domaine personnalisé affiché dans l’onglet Réglages.

Comment puis-je exporter mon site pour l’utiliser sur le site web WordPress Playground ?

WordPress Studio est propulsé par WordPress Playground. Si vous souhaitez importer votre site local sur playground.wordpress.net, créez un fichier ZIP à partir du contenu du dossier de votre site et utilisez le Site Explorer pour importer le ZIP dans votre navigateur.

Veuillez noter que les entrées de premier niveau comme wp-config.php doivent se trouver à la racine de l’archive. Pour ce faire, sélectionnez tous les fichiers et répertoires à l’intérieur du dossier du site lors de la création du fichier ZIP, plutôt que le dossier du site lui-même.

FAQ sur l’Assistant Studio

Voici quelques réponses aux questions fréquentes sur l’Assistant Studio. Veuillez consulter la documentation de l’Assistant Studio pour obtenir des instructions étape par étape et des conseils utiles sur l’utilisation de cette fonctionnalité.

D’où proviennent les réponses de l’Assistant ?

L’Assistant s’appuie sur l’infrastructure de WordPress.com et sur notre base de connaissances WordPress pour fournir des réponses utiles grâce à la génération augmentée par récupération (Retrieval Augmented Generation). C’est pourquoi il nécessite une connexion Internet et doit être connecté à un compte WordPress.com.

Quelles langues l’Assistant Studio prend-il en charge ?

Les exemples de requêtes que vous voyez lorsque vous commencez à utiliser l’Assistant seront affichés dans la langue que vous avez choisie pour Studio. Cela dit, vous pouvez communiquer avec l’Assistant dans la langue de votre choix. 

Puis-je utiliser l’Assistant Studio sans compte WordPress.com ?

Non, vous devez vous connecter à Studio avec votre compte WordPress.com pour utiliser l’Assistant Studio. En effet, nous utilisons l’infrastructure WordPress.com pour générer les messages et gérer les accès.

L’utilisation de l’Assistant Studio est-elle payante ?

C’est gratuit pour tout utilisateur WordPress.com, quel que soit votre plan. 

Combien de requêtes puis-je utiliser par mois ?

Chaque utilisateur dispose de 200 requêtes par mois sur l’ensemble de ses sites Studio. Si vous atteignez cette limite, vous devrez attendre le mois suivant pour que le compteur de requêtes soit réinitialisé.

Où puis-je donner mon avis sur les réponses de l’Assistant Studio ?

Il existe deux façons de donner votre avis sur les réponses de l’Assistant.

Premièrement, un mécanisme de retour est intégré aux réponses. Cliquez simplement sur Oui ou Non à la fin de chaque réponse pour transmettre votre avis à l’équipe WordPress Studio.

Deuxièmement, vous pouvez écrire au support pour partager des retours spécifiques sur les réponses de l’Assistant. 

FAQ sur Studio Sync

Voici quelques réponses aux questions fréquentes sur la fonctionnalité Studio Sync. Veuillez consulter la documentation Studio Sync pour obtenir des instructions étape par étape et des conseils utiles sur l’utilisation de cette fonctionnalité.

Pourquoi mes utilisateurs locaux n’apparaissent-ils pas sur le site WordPress.com après un envoi ?

Lors d’un envoi, WordPress Studio exporte tout votre contenu et l’intégralité de votre base de données, à l’exception des tables wp_users et wp_usermeta. Cela garantit que les fonctionnalités propulsées par Jetpack sur votre site WordPress.com (comme l’authentification unique ou l’optimisation des images) continuent de fonctionner après l’envoi.