1. WordPlate now requires PHP 7.4 or later.

2. Bump the version number in the composer.json file to ^10.0.

3. Rename WP_ENV to WP_ENVIRONMENT_TYPE in the environment file.

4. Rename WP_THEME to WP_DEFAULT_THEME in the environment file.

5. Rename WP_URL to WP_HOME in the environment file (if it exists).

6. If you're using the WP_CACHE environment variable you'll need to define it in the public/wp-config.php file:

   $application->run();
   
   +define('WP_CACHE', env('WP_CACHE', false));
   
   $table_prefix = env('DB_TABLE_PREFIX', 'wp_');

7. Optional: Rename WP_PREFIX to DB_TABLE_PREFIX in the following files:

   • .env
   • .env.example
   • public/wp-config.php

8. Run composer update in the root of your project.

1. Bump the version number in the composer.json file to ^9.0.

2. Copy the public/mu-plugins/mu-plugins.php file into your project.

3. Update the public/.gitignore file to allow the new mu-plugins.php file:

   -mu-plugins/
   +mu-plugins/*
   +!mu-plugins/mu-plugins.php

4. Run composer update in the root of your project.

1. WordPlate now requires PHP 7.2 or later.

2. Bump the version number in the composer.json file to ^8.0.

   Note: WordPlate 8.0 requires WordPress 5.3 or later.

3. Laravel's helper functions is now optional in WordPlate. If you want to use the functions, install the laravel/helpers package, with Composer, in the root of your project:

   composer require laravel/helpers

4. Laravel's collections are now optional in WordPlate. If you want to use collections, install the tightenco/collect package, with Composer, in the root of your project:

   composer require tightenco/collect

5. The mix helper function is now optional in WordPlate. If you want to use the function, install the ibox/mix-function package, with Composer, in the root of your project:

   composer require ibox/mix-function

6. Replace any usage of asset, stylesheet_url and template_url functions with WordPress's get_theme_file_uri function.

7. Replace any usage of stylesheet_path and template_path functions with WordPress's get_theme_file_path function .

8. The base_path and template_slug functions have been removed.

9. Run composer update in the root of your project.

1. Bump the version number in the composer.json file to ^7.0.

   Note: WordPlate 7.0 requires WordPress 5.0 or later.

2. Update the realpath(__DIR__) to realpath(__DIR__.'/../') in the wp-config.php file.

3. If your public directory isn't named public, add the following line to the wp-config.php file:

   $application->setPublicPath(realpath(__DIR__));

4. Run composer update in the root of your project.

1. Bump the version number in the composer.json file to ^6.0.

2. Update the realpath(__DIR__.'/../') to realpath(__DIR__) in the wp-config.php file.

3. Run composer update in the root of your project.

1. Bump the version number in the composer.json file to ^5.0.

2. Copy and paste the contents of the wp-config.php file into your application.

   Note: Make sure you don't overwrite any of your custom constants.

3. Run composer update in the root of your project.

This is possible by updating the public/wp-config.php file after the WordPlate application have been created.

$application->run();

+define('WP_ALLOW_MULTISITE', env('WP_ALLOW_MULTISITE', true));

$table_prefix = env('DB_TABLE_PREFIX', 'wp_');

Then you may add the constant to the .env file.

WP_DEFAULT_THEME=wordplate
+WP_ALLOW_MULTISITE=true

If you want to rename the public directory you'll need to add the following line to the wp-config.php file:

$application->setPublicPath(realpath(__DIR__));

Please note that you also have to update your composer.json file with your new public directory path before you can run composer update again.

By default WordPlate will put the WordPress in public/wordpress. If you want to change this there are a couple of steps you need to go through. Let's say you want to change the default WordPress location to public/wp:

1. Update the wordpress-install-dir path in your composer.json file.

2. Update wordpress to wp in wordplate/public/.gitignore.

3. Update the last line in the public/index.php file to:

   require __DIR__.'/wp/wp-blog-header.php';

4. Update the WP_DIR environment variable in the .env file to wp.

5. If you're using WP-CLI, update the path in the wp-cli.yml file to public/wp.

6. Remove the public/wordpress directory if it exist and then run composer update.

For most applications you may leave the theme directory as it is. If you want to rename the wordplate theme to something else you'll also need to update the WP_DEFAULT_THEME environment variable in the .env file.

If you're using Laravel Valet together with WordPlate, you may use our local valet driver. Create a file named LocalValetDriver.php in the root of your project and copy and paste the class below:

<?php

declare(strict_types=1);

final class LocalValetDriver extends BasicValetDriver
{
    public function serves(string $sitePath): bool
    {
        return is_dir($sitePath . '/vendor/wordplate/framework');
    }

    /**
     * @return false|string
     */
    public function isStaticFile(string $sitePath, string $siteName, string $uri)
    {
        $staticFilePath = $sitePath . '/public' . $uri;

        if ($this->isActualFile($staticFilePath)) {
            return $staticFilePath;
        }

        return false;
    }

    public function frontControllerPath(string $sitePath, string $siteName, string $uri): string
    {
        $_SERVER['PHP_SELF'] = $uri;
        $_SERVER['SERVER_NAME'] = $_SERVER['HTTP_HOST'];

        if (strpos($uri, '/wordpress/') === 0) {
            if (is_dir($sitePath . '/public' . $uri)) {
                $uri = $this->forceTrailingSlash($uri);

                return $sitePath . '/public' . $uri . '/index.php';
            }

            return $sitePath . '/public' . $uri;
        }

        return $sitePath . '/public/index.php';
    }

    private function forceTrailingSlash(string $uri): string
    {
        if (substr($uri, -1 * strlen('/wordpress/wp-admin')) == '/wordpress/wp-admin') {
            header('Location: ' . $uri . '/');
            die;
        }

        return $uri;
    }
}

1. It is possible to use Vite.js with WordPlate. First you'll need to replace the contents of the package.json file:

   {
       "private": true,
       "scripts": {
           "build": "vite build",
           "dev": "vite"
       },
       "dependencies": {
           "dotenv": "^10.0.0",
           "vite": "^2.6.14"
       }
   }

2. Remove the webpack.mix.js file from the root of your project.

3. Add a new file called vite.config.js in the root of your project and add the following script:

   require('dotenv').config();
   
   export default ({ command }) => ({
     base: command === 'serve' ? '/' : '/build/',
     publicDir: 'resources/static',
     build: {
       manifest: true,
       outDir: `public/themes/${process.env.WP_DEFAULT_THEME}/assets`,
       assetsDir: '',
       rollupOptions: {
         input: 'resources/scripts/index.js',
       },
     },
     plugins: [
         {
           name: 'php',
           handleHotUpdate({ file, server }) {
             if (file.endsWith('.php')) {
             server.ws.send({
               type: 'full-reload',
               path: '*',
             });
             }
           },
       },
     ],
   });

4. Remove the <script> tag from the footer.php file:

   -<script src="<?= get_theme_file_uri('assets/index.js') ?>" async></script>

5. Remove the <link> stylesheet tag from the header.php file:

   -<link rel="stylesheet" href="<?= get_theme_file_uri('assets/index.css') ?>">

6. Add the Vite.js <script> and <link> assets between the <head> tags in the header.php file:

   <?php if (
       wp_get_environment_type() === 'local' &&
       is_array(wp_remote_get('http://localhost:3000'))
   ) : ?>
       <script type="module" src="http://localhost:3000/@vite/client"></script>
       <script type="module" src="http://localhost:3000/resources/scripts/index.js"></script>
   <?php else : ?>
       <?php $manifest = json_decode(file_get_contents(get_theme_file_path('assets/manifest.json')), true); ?>
       <script type="module" src="<?= get_theme_file_uri('assets/' . $manifest['resources/scripts/index.js']['file']) ?>" defer></script>
       <link rel="stylesheet" href="<?= get_theme_file_uri('assets/' . $manifest['resources/scripts/index.js']['css'][0]) ?>">
   <?php endif; ?>

7. Import the index.css file in the resources/scripts/index.js file:

   +import '../styles/index.css';

8. Move any static files such as fonts and images into the resources/static directory.

9. Run npm install and then npm run dev to start the development server.