The server requirements are basically the same as for WordPress with the addition of a few ones:
The Themosis framework uses Composer to manage its dependencies and easily load its files. Please follow the instructions here in order to install Composer either locally or globally on your computer.
On Windows, you can use the Composer Windows installer.
We recommend you to install Composer globally on your system.
Console and execute the following command:
composer create-project themosis/themosis my-project-name
This will create a directory called
my-project-name on your computer and automatically download the latest WordPress version along with the latest Themosis framework version and its dependencies.
The Themosis framework is not configured to be hosted like a classic WordPress project. Compared to a classic WordPress installation, a Themosis project root is not the web server public directory.
When configuring your web server, make sure to point the web server to the project htdocs directory.
By default, the Themosis framework 3.0 supports Laravel Valet and is packaged with a local driver.
Currently, the local driver only supports a WordPress single instance installation. If you need to develop a multisite WordPress application, we recommend you to use Laravel Homestead.
The Themosis framework also works with Laravel Homestead.
Laravel Homestead can be installed globally or on a per-project basis.
Since release 3.0, the Laravel Homestead package is no longer installed by default with the Themosis framework.
In order to use Laravel Homestead on a per-project basis, make sure all requirements are installed on your computer then add the
laravel/homestead package to your project like so:
composer require laravel/homestead --dev
Once the package is installed, from your project root, run the following command in order to generate the required configuration files:
# macOS / Linux... php vendor/bin/homestead make # Windows... vendor\\bin\\homestead make
The code will install, at project root, a group of files in order to bootstrap your virtual machine. Open the
Homestead.yaml file and change the
sites -> to value to point to the framework default public directory
htdocs. Here is an example of a default configuration:
ip: 192.168.10.10 memory: 2048 cpus: 1 provider: virtualbox authorize: ~/.ssh/id_rsa.pub keys: - ~/.ssh/id_rsa folders: - map: /Users/username/web/my-project-name to: /home/vagrant/code sites: - map: homestead.test to: /home/vagrant/code/htdocs databases: - homestead name: themosis hostname: themosis
For more information regarding Homestead configuration, please read the official documentation.
Once your configuration of Homestead is complete, from the Terminal or Console, run the following command in order to start your development environment:
Before visiting the browser and in order to install WordPress, please make sure to first read the configuration guide.
With release 3.0 of the Themosis framework, we have replaced our previous Console CLI tool by the Laravel Artisan CLI tool. All commands from our previous tool are available with Artisan.
In order to view a list of all available commands, from your project root, run the following command:
For more information regarding Artisan, please read the official documentation.
On project installation, there is no default theme installed.
In order to install the new theme, go to the project root and run the
theme:install command from the terminal:
php artisan theme:install my-theme
The command will download and unzip a new theme into the
htdocs/content/themes/my-theme directory. The script is also setting up the theme
style.css file headers, the theme text domain and set it as the default theme for your WordPress application.
Habitually, you define your environment variables like database name, database user, authentication salts and other WordPress configurations inside the
With the Themosis framework, those configurations are extracted from the web root and located in the parent folder, at project root through the use of a
Follow the configuration guide and see how to configure your WordPress application.
Please note that the environment
APP_DEBUGvariable is now set to
falseby default in your
.envfile. We have turned off this setting due to WordPress still not being fully compatible with PHP8.1 and above. Feel free to turn on debug mode once WordPress is installed during development.
Read the configuration guide
Made in Belgium