Skip to content

Latest commit

 

History

History
81 lines (61 loc) · 6.06 KB

known-limitations.md

File metadata and controls

81 lines (61 loc) · 6.06 KB
Raw

Common errors

command not found: wp-now

You must install wp-now, please visit the NPM package page to install.

Known Limitations

These issues were pulled from the Playground Tools and WordPress Playground repositories.

Known Issues

See the WordPress Playground for all known issues. wp-now is a great tool and we look forward to hearing your feedback, stress testing the project, and improving it over time.

wp-cli

Very limited support for wp-cli outside of use with blueprints

  • WP-NOW: Add wp-cli integration #212
  • Shell steps don't work in wp-now - #1166

Boot modes

Quirky boot modes wp-now recognizes the context you are booting in, which can have some quirky behavior.

  • Replace "Mode" concept with auto-loading or explicit CLI flags #26
  • Data carrying-over between instances in VS Code extension - "Playground" mode #1184
  • Running wp-now start in 'wp-content' or 'wordpress' mode will produce some empty directories: WordPress/wordpress-playground#328
  • wp-now: don't expect a full wp-content directory in wp-content mode #244

Plugins and Themes

installPlugin and installTheme steps

  • wp-now: blueprint with installPlugin steps fails on subsequent runs #209

Must Use Plugins

  • wp-now doesn't support custom mu-plugins #73
  • What is the best way to load my mu-plugins? #198
  • mu-plugin folder not loaded when using pre-existing install #101
  • wp-now detects wp-content mode if there is a mu-plugins subdir inside the dir where it is executed. #234
  • The theme directory "twentytwentyfour" does not exist. #1240

Database and file systems

  • wp-now: Allow mounting host filesystem #245
  • WordPress crashes when connecting to MySQL #237
  • wp-now: Error establishing database connection when 'DB_HOST' is 'localhost' #18
  • Local Environment: Workflow to import an existing MySQL database #15
  • Allow a configuration to map other folders and files #19
  • wp-now: crashes when trying to access wp-admin with a remote database #1052
  • .wp-now/mu-plugins/sqlite-database-integration-main/db.copy: Not a directory or a symbolic link to a directory #230
    • Must install the sqlite-database-integration plugin

Routing

  • Inline images are broken when site starts on a different port: WordPress/wordpress-playground#356
  • In 'wordpress' mode, wp-now can connect to a MySQL database with define( 'DB_HOST', '127.0.0.1' );, but define( 'DB_HOST', 'localhost' ); does not work: WordPress/wordpress-playground#369
  • SSL: Local Environment: Support SSL connections #24
  • wp-now: Error starting: getaddrinfo ENOTFOUND #32

Windows

Debugging

Blueprint steps

  • wp-now does not activate plugins or themes via activatePlugin and activateTheme step. #241

Importing and exporting - Migrations

  • Playground Plugin: Can't import via .sql file - #1124
    • Blocked by needing Passwordless login
  • Image links broken when moving from wordpress-playground to wp-now #942
  • CORS header workaround needed for Theme Unit Test import #718
  • Plugins on SVN won't properly import test data (see #99)

Performance

  • wp-now: out of memory error when running for many hours #96
  • wp-now only runs a single PHP process which means PHP cannot issue a HTTP request to itself. #239