diff --git a/packages/docs/site/docs/developers/24-limitations/01-index.md b/packages/docs/site/docs/developers/24-limitations/01-index.md index 166646c5ef..c384884585 100644 --- a/packages/docs/site/docs/developers/24-limitations/01-index.md +++ b/packages/docs/site/docs/developers/24-limitations/01-index.md @@ -69,8 +69,8 @@ Loading times vary based on what Playground needs to set up: **Factors that affect performance:** - **Plugin size**: Large plugins take longer to install at runtime -- **Network speed**: WASM files are 15-30MB -- **Device memory**: Low-memory devices may experience slowdowns +- **Network speed**: WASM files are approximately 5-15MB per PHP version (reduced significantly by the MAIN_MODULE=2 build optimization) +- **Device memory**: Initial WASM memory allocation is 64MB, growing dynamically as needed. Low-memory devices may experience slowdowns - **Browser**: Chrome/Edge perform best; Safari slightly slower
@@ -81,12 +81,12 @@ Loading times vary based on what Playground needs to set up: ### Iframe quirks {#iframe-quirks} -Playground renders WordPress in an [`iframe`](/developers/architecture/browser-iframe-rendering) so clicking links with `target="_top"` will reload the page you’re working on. +Playground renders WordPress in an [`iframe`](/developers/architecture/browser-iframe-rendering) so clicking links with `target="_top"` will reload the page you're working on. Also, JavaScript popups originating in the `iframe` may not always display. ### Run WordPress PHP functions {#run-wordpress-php-functions} -Playground supports running PHP code in Blueprints using the [`runPHP` step](/blueprints/steps#RunPHPStep). To run WordPress-specific PHP functions, you’d need to first require [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php): +Playground supports running PHP code in Blueprints using the [`runPHP` step](/blueprints/steps#RunPHPStep). To run WordPress-specific PHP functions, you'd need to first require [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php): ```json { @@ -98,3 +98,14 @@ Playground supports running PHP code in Blueprints using the [`runPHP` step](/ ### Using WP-CLI {#using-wp-cli} You can execute `wp-cli` commands via the Blueprints [`wp-cli`](/blueprints/steps#WPCLIStep) step. However, since Playground runs in the browser, it doesn't support the [full array](https://developer.wordpress.org/cli/commands/) of available commands. While there is no definite list of supported commands, experimenting in [the online demo](https://playground.wordpress.net/demos/wp-cli.html) will help you assess what's possible. + +When using the [Playground CLI](/developers/local-development/wp-playground-cli), the `php` command provides full WP-CLI support by running scripts directly against the WASM PHP runtime. + +## Recent improvements {#recent-improvements} + +Several previous limitations have been addressed in recent releases: + +- **Large file downloads (>2GB)**: File exports and downloads now stream directly instead of buffering in memory, enabling large site exports (e.g., All-in-One WP Migration backups) that previously failed. +- **PHP curl file uploads**: Multipart form uploads via `CURLFile` now work correctly in the browser. The `Expect: 100-continue` deadlock and CORS proxy multipart forwarding issues have been resolved. +- **Long-running PHP responses**: The service worker now streams PHP responses instead of buffering them, eliminating the 25-second timeout that previously caused site imports and other long-running operations to fail. +- **Download error handling**: When WASM or script downloads fail (due to network issues, ad blockers, etc.), Playground now displays a helpful error modal instead of a blank page. diff --git a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md index 6b61d79832..49986549a0 100644 --- a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md +++ b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md @@ -1,145 +1,217 @@ --- slug: /developers/limitations - -description: Conoce las limitaciones actuales de WordPress Playground, incluyendo comportamientos específicos del navegador, almacenamiento temporal por diseño, peculiaridades de iframe y soporte de WP-CLI. +description: Conoce las limitaciones actuales de WordPress Playground, incluidos los comportamientos específicos del navegador, el almacenamiento temporal por diseño, las peculiaridades de los iframes y la compatibilidad con WP-CLI. --- - + # Limitaciones - + -WordPress Playground está en desarrollo activo y tiene algunas limitaciones que debes tener en cuenta al ejecutarlo y desarrollar con él. +WordPress Playground está en desarrollo activo y tiene algunas limitaciones que conviene tener en cuenta al ejecutarlo y al desarrollar con él. - + -Puedes seguir el estado de estos problemas en el [tablero del proyecto Playground](https://github.com/orgs/WordPress/projects/180). +Puedes seguir el estado de estos temas en el [tablero del proyecto Playground](https://github.com/orgs/WordPress/projects/180). - + ## En el navegador {#in-the-browser} - + ### Temporal por diseño {#temporary-by-design} - + -Playground crea instancias frescas de WordPress en cada carga de página. Actualizar la página del navegador descarta todos los cambios en la base de datos, archivos subidos y modificaciones. +Playground crea instancias nuevas de WordPress en cada carga de página. Al actualizar la página del navegador se descartan todos los cambios en la base de datos, los archivos subidos y las demás modificaciones. - + -**Por qué sucede esto**: Playground transmite WordPress directamente a tu navegador en lugar de servirlo desde un servidor tradicional. Cada actualización comienza desde cero. +**Por qué ocurre**: Playground transmite WordPress directamente al navegador en lugar de servirlo desde un servidor tradicional. Cada actualización empieza desde cero. - + **Para conservar tu trabajo:** - - + -- **Guardar**: Activa el almacenamiento del navegador mediante el botón "Guardar" (arriba a la derecha, junto a la barra de direcciones), antes de actualizar la página a través de la barra del navegador. -- **Para desarrollo**: Usa [Playground CLI](/developers/local-development/wp-playground-cli) que soporta almacenamiento local persistente +- **Guardar**: activa el almacenamiento del navegador con el botón «Save» (arriba a la derecha, junto a la barra de direcciones) antes de actualizar la página con la barra del navegador. +- **Para desarrollo**: usa [Playground CLI](/developers/local-development/wp-playground-cli), que admite almacenamiento local persistente - - - + :::tip -El botón de actualización dedicado dentro de Playground solo recarga el contenido de WordPress—preserva tu estado de PHP/WP. El botón de actualización del navegador (F5 o Cmd+R) destruye la instancia completa. +El botón de actualización integrado en Playground solo vuelve a cargar el contenido de WordPress: conserva el estado de PHP/WP. El botón de actualización del navegador (F5 o Cmd+R) destruye toda la instancia. ::: ![Refresh Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/refresh-playground-button.webp)
- -
1. Exportando Playground:
+
1. Exportar Playground:
+ + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/export-playground.webp)
- -
2. Botón Guardar:
+
2. Botón Save:
+ + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/saving-playground.webp)
- - ### Compatibilidad con navegadores {#browser-support} - + -WordPress Playground está diseñado para funcionar en todos los principales navegadores de escritorio y móviles. Esto incluye: +WordPress Playground está pensado para funcionar en los principales navegadores de escritorio y móviles. Esto incluye: - - + -- **Navegadores de escritorio**: Chrome, Firefox, Safari, Edge y otros navegadores basados en Chromium -- **Navegadores móviles**: Safari (iOS), Chrome (Android) y otras variantes de navegadores móviles +- **Navegadores de escritorio**: Chrome, Firefox, Safari, Edge y otros basados en Chromium +- **Navegadores móviles**: Safari (iOS), Chrome (Android) y otras variantes - + -Playground aprovecha las tecnologías web modernas y debería funcionar de manera consistente en estos entornos de navegador. Sin embargo, algunas funciones avanzadas pueden tener diferentes niveles de soporte dependiendo del navegador específico y su versión. +Playground aprovecha tecnologías web modernas y debería comportarse de forma coherente en estos entornos. No obstante, algunas funciones avanzadas pueden tener distinto nivel de soporte según el navegador y su versión. - + ### Expectativas de rendimiento {#performance-expectations} - + + +Los tiempos de carga dependen de lo que Playground necesite preparar: + + -Los tiempos de carga varían según lo que Playground necesita configurar: +| Escenario | Tiempo de carga típico | +| ---------------------------------------- | ---------------------------------- | +| WordPress nuevo (sin plugins) | 5-10 segundos | +| Con plugins pequeños | 10-20 segundos | +| Con plugins grandes (p. ej. WooCommerce) | 30-60 segundos | +| En dispositivos móviles | 1,5-2× más lento que en escritorio | + + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/playground-performance-graph.webp) - +**Factores que influyen en el rendimiento:** -**Factores que afectan el rendimiento:** + - - - - +- **Tamaño del plugin**: los plugins grandes tardan más en instalarse en tiempo de ejecución +- **Velocidad de red**: los archivos WASM rondan los 5-15 MB por versión de PHP (reducidos de forma notable por la optimización de compilación `MAIN_MODULE=2`) +- **Memoria del dispositivo**: la asignación inicial de memoria WASM es de 64 MB y crece dinámicamente si hace falta. Los dispositivos con poca memoria pueden ir más lentos +- **Navegador**: Chrome y Edge suelen ir mejor; Safari, un poco más lento -- **Tamaño del plugin**: Los plugins grandes tardan más en instalarse en tiempo de ejecución -- **Velocidad de red**: Los archivos WASM son de 15-30MB -- **Memoria del dispositivo**: Los dispositivos con poca memoria pueden experimentar ralentizaciones -- **Navegador**: Chrome/Edge tienen mejor rendimiento; Safari es ligeramente más lento +
- -Nota: El soporte para Opera Mini no está confirmado actualmente. +Nota: el soporte de Opera Mini no está confirmado por ahora.
- + ## Al desarrollar con Playground {#when-developing-with-playground} - + -### Peculiaridades del iframe {#iframe-quirks} +### Particularidades del iframe {#iframe-quirks} - + -Playground renderiza WordPress en un [`iframe`](/developers/architecture/browser-iframe-rendering), por lo que hacer clic en enlaces con `target="_top"` recargará la página en la que estás trabajando. +Playground muestra WordPress en un [`iframe`](/developers/architecture/browser-iframe-rendering), así que al hacer clic en enlaces con `target="_top"` se recarga la página en la que trabajas. - + -Además, los popups de JavaScript que se originan en el `iframe` pueden no mostrarse siempre. +Además, las ventanas emergentes de JavaScript que se originan en el `iframe` no siempre se muestran. - + ### Ejecutar funciones PHP de WordPress {#run-wordpress-php-functions} - + + +Playground permite ejecutar código PHP en Blueprints con el [paso `runPHP`](/blueprints/steps#RunPHPStep). Para usar funciones PHP de WordPress, primero hay que cargar [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php): -Playground soporta la ejecución de código PHP en Blueprints usando el [paso `runPHP`](/blueprints/steps#RunPHPStep). Para ejecutar funciones PHP específicas de WordPress, primero necesitas requerir [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php): + ```json { @@ -148,10 +220,44 @@ Playground soporta la ejecución de código PHP en Blueprints usando el [paso `r } ``` - +### Uso de WP-CLI {#using-wp-cli} + + + +Puedes ejecutar comandos `wp-cli` mediante el [paso `wp-cli`](/blueprints/steps#WPCLIStep) de Blueprints. Como Playground se ejecuta en el navegador, no admite la [lista completa](https://developer.wordpress.org/cli/commands/) de comandos disponibles. No hay una lista cerrada de comandos soportados; probar [la demo en línea](https://playground.wordpress.net/demos/wp-cli.html) ayuda a ver qué es posible. + + + +Si usas [Playground CLI](/developers/local-development/wp-playground-cli), el comando `php` ofrece WP-CLI completo ejecutando los scripts directamente contra el runtime PHP en WASM. + + + +## Mejoras recientes {#recent-improvements} + + + +Varias limitaciones anteriores se han abordado en versiones recientes: -### Usando WP-CLI {#using-wp-cli} + - +- **Descargas de archivos grandes (>2 GB)**: Exportaciones y descargas ahora se transmiten en streaming en lugar de cargarse en memoria, lo que permite exportar sitios grandes (p. ej. copias de All-in-One WP Migration) que antes fallaban. +- **Subidas de archivos cURL en PHP**: Las subidas multipart con `CURLFile` ya funcionan bien en el navegador. Se han resuelto el bloqueo de `Expect: 100-continue` y los problemas de reenvío multipart del proxy CORS. +- **Respuestas PHP largas**: El service worker ahora transmite las respuestas PHP en lugar de almacenarlas en búfer, eliminando el tiempo de espera de 25 segundos que hacía fallar importaciones de sitios y otras operaciones largas. +- **Errores de descarga**: Si fallan las descargas de WASM o scripts (por red, bloqueadores de anuncios, etc.), Playground muestra un modal de error útil en lugar de una página en blanco. -Puedes ejecutar comandos `wp-cli` a través del paso [`wp-cli`](/blueprints/steps#WPCLIStep) de Blueprints. Sin embargo, como Playground se ejecuta en el navegador, no soporta la [lista completa](https://developer.wordpress.org/cli/commands/) de comandos disponibles. Aunque no existe una lista definitiva de comandos soportados, experimentar en [la demo en línea](https://playground.wordpress.net/demos/wp-cli.html) te ayudará a evaluar lo que es posible. + diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md index 9c76d63d40..27c46d298d 100644 --- a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md @@ -1,145 +1,223 @@ --- slug: /developers/limitations - -description: Découvrez les limitations actuelles de WordPress Playground, notamment les comportements spécifiques aux navigateurs, le stockage temporaire par conception, les particularités des iframes et le support WP-CLI. +description: Découvrez les limitations actuelles de WordPress Playground, notamment les comportements propres aux navigateurs, le stockage temporaire voulu, les particularités des iframes et la prise en charge de WP-CLI. --- - + # Limitations - + -WordPress Playground est en développement actif et présente certaines limitations que vous devez garder à l'esprit lors de son utilisation et du développement avec celui-ci. +WordPress Playground est en développement actif et présente certaines limitations à garder à l’esprit lorsque vous l’utilisez. - + -Vous pouvez suivre l'état de ces problèmes sur le [tableau de bord du projet Playground](https://github.com/orgs/WordPress/projects/180). +Vous pouvez suivre l’état de ces sujets sur le [tableau du projet Playground](https://github.com/orgs/WordPress/projects/180). - + ## Dans le navigateur {#in-the-browser} - + ### Conçu pour être temporaire {#temporary-by-design} - + -Playground crée des instances WordPress fraîches à chaque chargement de page. Actualiser la page du navigateur supprime toutes les modifications de la base de données, les téléversements et les modifications. +Playground crée à chaque chargement de page des instances WordPress neuves. Actualiser la page du navigateur supprime toutes les modifications de la base de données, les téléversements et les autres changements. - + -**Pourquoi cela se produit** : Playground diffuse WordPress directement vers votre navigateur plutôt que de le servir depuis un serveur traditionnel. Chaque actualisation repart de zéro. +**Pourquoi c’est ainsi** : Playground diffuse WordPress directement vers votre navigateur plutôt que de le servir depuis un serveur classique. Chaque actualisation repart de zéro. - + **Pour conserver votre travail :** - - + + +- **Enregistrer** : activez le stockage du navigateur via le bouton « Save » (en haut à droite, à côté de la barre d’adresse) avant d’actualiser la page avec la barre du navigateur. +- **Pour le développement** : utilisez [Playground CLI](/developers/local-development/wp-playground-cli), qui prend en charge un stockage local persistant -- **Enregistrer** : Activez le stockage du navigateur via le bouton "Enregistrer" (en haut à droite, à côté de la barre d'adresse), avant d'actualiser la page via la barre du navigateur. -- **Pour le développement** : Utilisez [Playground CLI](/developers/local-development/wp-playground-cli) qui prend en charge le stockage local persistant + - - - +:::tip +Le bouton d’actualisation dédié dans Playground ne recharge que le contenu WordPress — il préserve votre état PHP/WP. Le bouton d’actualisation du navigateur (F5 ou Cmd+R) détruit toute l’instance. +::: + ![Refresh Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/refresh-playground-button.webp)
- -
1. Exportation de Playground :
+
1. Exporter Playground :
+ + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/export-playground.webp)
- -
2. Bouton Enregistrer :
+
2. Bouton Save :
+ + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/saving-playground.webp)
- - ### Compatibilité des navigateurs {#browser-support} - + + +WordPress Playground est pensé pour fonctionner sur les principaux navigateurs de bureau et mobiles. Cela inclut : + + -WordPress Playground est conçu pour fonctionner sur tous les principaux navigateurs de bureau et mobiles. Cela inclut : +- **Navigateurs de bureau** : Chrome, Firefox, Safari, Edge et autres navigateurs basés sur Chromium +- **Navigateurs mobiles** : Safari (iOS), Chrome (Android) et autres variantes - - + -- **Navigateurs de bureau** : Chrome, Firefox, Safari, Edge et autres navigateurs basés sur Chromium -- **Navigateurs mobiles** : Safari (iOS), Chrome (Android) et autres variantes de navigateurs mobiles +Playground s’appuie sur des technologies web récentes et doit se comporter de façon cohérente dans ces environnements. Toutefois, certaines fonctionnalités avancées peuvent être prises en charge différemment selon le navigateur et sa version. - + -Playground exploite les technologies web modernes et devrait fonctionner de manière cohérente dans ces environnements de navigateur. Cependant, certaines fonctionnalités avancées peuvent avoir différents niveaux de support selon le navigateur spécifique et sa version. +### Attentes en matière de performances {#performance-expectations} - + -### Attentes de performance {#performance-expectations} +Les temps de chargement varient selon ce que Playground doit mettre en place : - + -Les temps de chargement varient en fonction de ce que Playground doit configurer : +| Scénario | Temps de chargement typique | +| ----------------------------------------------- | ------------------------------------- | +| WordPress seul (sans extensions) | 5 à 10 secondes | +| Avec de petites extensions | 10 à 20 secondes | +| Avec de grosses extensions (p. ex. WooCommerce) | 30 à 60 secondes | +| Sur appareils mobiles | 1,5 à 2× plus lent que sur ordinateur | + + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/playground-performance-graph.webp) - +**Facteurs qui influençants les performances :** -**Facteurs qui affectent la performance :** + - - - - +- **Taille des extensions** : les grosses extensions mettent plus longtemps à s’installer à l’exécution +- **Débit réseau** : les fichiers WASM font environ 5 à 15 Mo par version de PHP (réduits nettement grâce à l’optimisation de compilation `MAIN_MODULE=2`) +- **Mémoire de l’appareil** : l’allocation mémoire WASM initiale est de 64 Mo, puis augmente dynamiquement si besoin. Les appareils peu dotés en mémoire peuvent ralentir +- **Navigateur** : Chrome et Edge offrent en général les meilleures performances ; Safari est légèrement plus lent -- **Taille du plugin** : Les gros plugins prennent plus de temps à s'installer à l'exécution -- **Vitesse du réseau** : Les fichiers WASM font 15-30 Mo -- **Mémoire de l'appareil** : Les appareils avec peu de mémoire peuvent connaître des ralentissements -- **Navigateur** : Chrome/Edge offrent les meilleures performances ; Safari est légèrement plus lent +
- -Note : Le support d'Opera Mini n'est pas actuellement confirmé. +Note : la prise en charge d’Opera Mini n’est pas confirmée pour l’instant.
- + ## Lors du développement avec Playground {#when-developing-with-playground} - + ### Particularités des iframes {#iframe-quirks} - + -Playground affiche WordPress dans un [`iframe`](/developers/architecture/browser-iframe-rendering), donc cliquer sur des liens avec `target="_top"` rechargera la page sur laquelle vous travaillez. +Playground affiche WordPress dans un [`iframe`](/developers/architecture/browser-iframe-rendering) : cliquer sur des liens avec `target="_top"` recharge donc la page sur laquelle vous travaillez. - + -De plus, les popups JavaScript provenant de l'`iframe` peuvent ne pas toujours s'afficher. +De plus, les fenêtres popup JavaScript issues de l’`iframe` ne s’affichent pas toujours. - + ### Exécuter des fonctions PHP WordPress {#run-wordpress-php-functions} - + -Playground prend en charge l'exécution de code PHP dans les Blueprints en utilisant l'[étape `runPHP`](/blueprints/steps#RunPHPStep). Pour exécuter des fonctions PHP spécifiques à WordPress, vous devez d'abord inclure [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php) : +Playground permet d’exécuter du code PHP dans les Blueprints via l’[étape `runPHP`](/blueprints/steps#RunPHPStep). Pour appeler des fonctions PHP propres à WordPress, il faut d’abord inclure [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php) : + + ```json { @@ -148,10 +226,44 @@ Playground prend en charge l'exécution de code PHP dans les Blueprints en utili } ``` - - ### Utilisation de WP-CLI {#using-wp-cli} - + + +Vous pouvez exécuter des commandes `wp-cli` via l’[étape `wp-cli`](/blueprints/steps#WPCLIStep) des Blueprints. Comme Playground s’exécute dans le navigateur, il ne prend pas en charge la [totalité](https://developer.wordpress.org/cli/commands/) des commandes disponibles. Il n’existe pas de liste officielle des commandes prises en charge ; tester [la démo en ligne](https://playground.wordpress.net/demos/wp-cli.html) permet d’en juger. + + + +Avec [Playground CLI](/developers/local-development/wp-playground-cli), la commande `php` offre une prise en charge complète de WP-CLI en exécutant les scripts directement sur le runtime PHP WASM. + + + +## Améliorations récentes {#recent-improvements} + + + +Plusieurs limitations antérieures ont été levées dans des versions récentes : + + + +- **Téléchargements de fichiers volumineux (>2 Go)** : les exportations et téléchargements sont désormais diffusés en flux direct plutôt qu’en mémoire tampon, ce qui permet d’exporter des sites volumineux (p. ex. sauvegardes All-in-One WP Migration) qui échouaient auparavant. +- **Téléversements de fichiers cURL en PHP** : les envois de formulaires multipart via `CURLFile` fonctionnent correctement dans le navigateur. Le blocage lié à `Expect: 100-continue` et les problèmes de transmission multipart via le proxy CORS sont résolus. +- **Réponses PHP longues** : le service worker diffuse désormais les réponses PHP au lieu de les mettre en mémoire tampon, ce qui supprime le délai d’expiration de 25 secondes qui faisait échouer les importations de site et d’autres opérations longues. +- **Gestion des erreurs de téléchargement** : en cas d’échec du téléchargement de WASM ou de scripts (réseau, bloqueur de publicités, etc.), Playground affiche une boîte d’erreur utile au lieu d’une page vide. -Vous pouvez exécuter des commandes `wp-cli` via l'étape [`wp-cli`](/blueprints/steps#WPCLIStep) des Blueprints. Cependant, comme Playground s'exécute dans le navigateur, il ne prend pas en charge la [liste complète](https://developer.wordpress.org/cli/commands/) des commandes disponibles. Bien qu'il n'existe pas de liste définitive des commandes prises en charge, expérimenter avec [la démo en ligne](https://playground.wordpress.net/demos/wp-cli.html) vous aidera à évaluer ce qui est possible. + diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md index 4a998086e9..54efa43f6a 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/24-limitations/01-index.md @@ -1,60 +1,76 @@ --- slug: /developers/limitations - description: Conheça as limitações atuais do WordPress Playground, incluindo comportamentos específicos do navegador, armazenamento temporário por design, peculiaridades de iframe e suporte ao WP-CLI. --- - + # Limitações - + -O WordPress Playground está em desenvolvimento ativo e possui algumas limitações que você deve ter em mente ao utilizá-lo e desenvolver com ele. +O WordPress Playground está em desenvolvimento ativo e tem algumas limitações que você deve considerar ao executá-lo e ao desenvolver com ele. - + Você pode acompanhar o status dessas questões no [quadro do projeto Playground](https://github.com/orgs/WordPress/projects/180). - + ## No navegador {#in-the-browser} - + ### Temporário por design {#temporary-by-design} - + -O Playground cria instâncias frescas do WordPress a cada carregamento de página. Atualizar a página do navegador descarta todas as alterações no banco de dados, uploads e modificações. +O Playground cria instâncias novas do WordPress a cada carregamento de página. Atualizar a página do navegador descarta todas as alterações no banco de dados, uploads e modificações. - + -**Por que isso acontece**: O Playground transmite o WordPress diretamente para o seu navegador em vez de servi-lo de um servidor tradicional. Cada atualização começa do zero. +**Por que isso acontece**: o Playground transmite o WordPress diretamente para o seu navegador em vez de servi-lo a partir de um servidor tradicional. Cada atualização recomeça do zero. - + **Para preservar seu trabalho:** - - + -- **Salvar**: Ative o armazenamento do navegador através do botão "Salvar" (canto superior direito, ao lado da barra de endereços), antes de atualizar a página pela barra do navegador. -- **Para desenvolvimento**: Use o [Playground CLI](/developers/local-development/wp-playground-cli) que suporta armazenamento local persistente +- **Salvar**: ative o armazenamento do navegador pelo botão “Save” (canto superior direito, ao lado da barra de endereços) antes de atualizar a página pela barra do navegador. +- **Para desenvolvimento**: use o [Playground CLI](/developers/local-development/wp-playground-cli), que oferece armazenamento local persistente - - - + :::tip -O botão de atualização dedicado dentro do Playground apenas recarrega o conteúdo do WordPress—ele preserva seu estado PHP/WP. O botão de atualização do navegador (F5 ou Cmd+R) destrói a instância inteira. +O botão de atualização dedicado dentro do Playground apenas recarrega o conteúdo do WordPress — ele preserva o estado PHP/WP. O botão de atualização do navegador (F5 ou Cmd+R) destrói a instância inteira. ::: ![Refresh Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/refresh-playground-button.webp)
-
1. Exportando o Playground:
![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/export-playground.webp) @@ -62,84 +78,140 @@ O botão de atualização dedicado dentro do Playground apenas recarrega o conte
- -
2. Botão Salvar:
+
2. Botão Save:
+ + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/saving-playground.webp)
- - ### Suporte a navegadores {#browser-support} - + -O WordPress Playground foi projetado para funcionar em todos os principais navegadores de desktop e mobile. Isso inclui: +O WordPress Playground foi feito para funcionar nos principais navegadores de desktop e mobile. Isso inclui: - - + -- **Navegadores desktop**: Chrome, Firefox, Safari, Edge e outros navegadores baseados em Chromium -- **Navegadores mobile**: Safari (iOS), Chrome (Android) e outras variantes de navegadores mobile +- **Navegadores desktop**: Chrome, Firefox, Safari, Edge e outros baseados em Chromium +- **Navegadores mobile**: Safari (iOS), Chrome (Android) e outras variantes - + -O Playground utiliza tecnologias web modernas e deve funcionar consistentemente nesses ambientes de navegador. No entanto, alguns recursos avançados podem ter diferentes níveis de suporte dependendo do navegador específico e sua versão. +O Playground usa tecnologias web modernas e deve se comportar de forma consistente nesses ambientes. Ainda assim, alguns recursos avançados podem ter níveis de suporte diferentes conforme o navegador e a versão. - + ### Expectativas de desempenho {#performance-expectations} - + + +Os tempos de carregamento variam conforme o que o Playground precisa configurar: + + + +| Cenário | Tempo de carregamento típico | +| -------------------------------------- | -------------------------------- | +| WordPress novo (sem plugins) | 5–10 segundos | +| Com plugins pequenos | 10–20 segundos | +| Com plugins grandes (ex.: WooCommerce) | 30–60 segundos | +| Em dispositivos móveis | 1,5–2× mais lento que no desktop | -Os tempos de carregamento variam de acordo com o que o Playground precisa configurar: + ![Save Button](https://raw.githubusercontent.com/WordPress/wordpress-playground/refs/heads/trunk/packages/docs/site/static/img/playground-performance-graph.webp) - + **Fatores que afetam o desempenho:** - - - - + -- **Tamanho do plugin**: Plugins grandes demoram mais para instalar em tempo de execução -- **Velocidade da rede**: Arquivos WASM têm 15-30MB -- **Memória do dispositivo**: Dispositivos com pouca memória podem apresentar lentidão -- **Navegador**: Chrome/Edge têm melhor desempenho; Safari é ligeiramente mais lento +- **Tamanho do plugin**: plugins grandes demoram mais para instalar em tempo de execução +- **Velocidade da rede**: arquivos WASM têm cerca de 5–15 MB por versão do PHP (reduzidos de forma significativa pela otimização de build `MAIN_MODULE=2`) +- **Memória do dispositivo**: a alocação inicial de memória WASM é de 64 MB, crescendo dinamicamente conforme necessário. Dispositivos com pouca memória podem ficar mais lentos +- **Navegador**: Chrome e Edge costumam ter melhor desempenho; Safari, um pouco mais lento + +
- -Nota: O suporte ao Opera Mini não está confirmado atualmente. +Nota: o suporte ao Opera Mini ainda não está confirmado.
- + ## Ao desenvolver com o Playground {#when-developing-with-playground} - + ### Peculiaridades do iframe {#iframe-quirks} - + -O Playground renderiza o WordPress em um [`iframe`](/developers/architecture/browser-iframe-rendering), então clicar em links com `target="_top"` recarregará a página em que você está trabalhando. +O Playground renderiza o WordPress em um [`iframe`](/developers/architecture/browser-iframe-rendering), então clicar em links com `target="_top"` recarrega a página em que você está trabalhando. - + -Além disso, pop-ups JavaScript originados no `iframe` podem nem sempre ser exibidos. +Além disso, pop-ups JavaScript originados no `iframe` podem nem sempre aparecer. - + ### Executar funções PHP do WordPress {#run-wordpress-php-functions} - + + +O Playground permite executar código PHP em Blueprints com o [passo `runPHP`](/blueprints/steps#RunPHPStep). Para usar funções PHP específicas do WordPress, é preciso antes incluir [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php): -O Playground suporta a execução de código PHP em Blueprints usando o [passo `runPHP`](/blueprints/steps#RunPHPStep). Para executar funções PHP específicas do WordPress, é necessário primeiro importar [wp-load.php](https://github.com/WordPress/WordPress/blob/master/wp-load.php): + ```json { @@ -148,10 +220,44 @@ O Playground suporta a execução de código PHP em Blueprints usando o [passo ` } ``` - +### Uso do WP-CLI {#using-wp-cli} + + + +Você pode executar comandos `wp-cli` pelo [passo `wp-cli`](/blueprints/steps#WPCLIStep) dos Blueprints. Como o Playground roda no navegador, ele não cobre a [lista completa](https://developer.wordpress.org/cli/commands/) de comandos disponíveis. Não há uma lista definitiva de comandos suportados; testar na [demo online](https://playground.wordpress.net/demos/wp-cli.html) ajuda a ver o que é possível. + + + +Com [Playground CLI](/developers/local-development/wp-playground-cli), o comando `php` oferece WP-CLI completo ao executar scripts diretamente no runtime PHP em WASM. + + + +## Melhorias recentes {#recent-improvements} + + + +Várias limitações anteriores foram tratadas em lançamentos recentes: -### Usando WP-CLI {#using-wp-cli} + - +- **Downloads de arquivos grandes (>2 GB)**: exportações e downloads agora são transmitidos em fluxo direto em vez de ficarem em buffer na memória, permitindo exportar sites grandes (por exemplo, backups do All-in-One WP Migration) que antes falhavam. +- **Uploads via cURL no PHP**: envios multipart com `CURLFile` passam a funcionar corretamente no navegador. O deadlock de `Expect: 100-continue` e os problemas de encaminhamento multipart no proxy CORS foram resolvidos. +- **Respostas PHP longas**: o service worker agora transmite as respostas PHP em vez de armazená-las em buffer, eliminando o timeout de 25 segundos que fazia falhar importações de site e outras operações longas. +- **Tratamento de erros de download**: quando downloads de WASM ou scripts falham (rede, bloqueadores de anúncios etc.), o Playground exibe um modal de erro útil em vez de uma página em branco. -Você pode executar comandos `wp-cli` através do passo [`wp-cli`](/blueprints/steps#WPCLIStep) dos Blueprints. No entanto, como o Playground roda no navegador, ele não suporta a [lista completa](https://developer.wordpress.org/cli/commands/) de comandos disponíveis. Embora não haja uma lista definitiva de comandos suportados, experimentar na [demonstração online](https://playground.wordpress.net/demos/wp-cli.html) ajudará você a avaliar o que é possível. +