Skip to content

Installation

Meet WpStarter

WpStarter is a Laravel port which integrated with WordPress. Provides Laravel syntax for developing WordPress application.

WpStarter strives to provide an amazing developer experience, all powerful of Laravel are ready in your WordPress application.

Why WpStarter?

There are a variety of tools and frameworks available to you when building a web application. We keep all Laravel stuffs and integrate them with WordPress like Eloquent using $wpdb, Laravel Mail send via wp_mail,... All Laravel classes available under WpStarter namespace, all Laravel helpers available under ws_ prefix

Your First WpStarter Project

WpStarter can be installed as a WordPress plugin

Installation Via Composer

If your computer doesn't have Composer installed get it at https://getcomposer.org/ first. Then you may create WpStarter project with composer. After the application has been created, you may copy it to plugins folder and activate it

composer create-project "wpstarter/wpstarter:^1.*" example-plugin

Installation within WordPress root directory

WpStarter can be placed outside plugins directory. It's highly recommend to put it inside WordPress root and load it via a mu-plugin. It's more convenient as we don't have to open many nested directories see our app, also easier when run command line. Just cd example-plugin instead of cd wp-content/plugins/example-plugin

You can move WpStarter to WordPress's root directory by create a mu plugin wp-content/mu-plugins/example-plugin.php and require WpStarter's main.php

<?php
/**
* Plugin name: My Example Plugin
*/
require ABSPATH.'/example-plugin/main.php';

Initial Configuration

All of the configuration files for the WpStarter framework are stored in the config directory. Each option is documented, so feel free to look through the files and get familiar with the options available to you.

WpStarter needs almost no additional configuration out of the box. You are free to get started developing! However, you may wish to review the config/app.php file and its documentation. It contains several options such as timezone and locale that you may wish to change according to your application.

Environment Based Configuration

Since many of WpStarter's configuration option values may vary depending on whether your application is running on your local computer or on a production web server, many important configuration values are defined using the .env file that exists at the root of your application.

Your .env file should not be committed to your application's source control, since each developer / server using your application could require a different environment configuration. Furthermore, this would be a security risk in the event an intruder gains access to your source control repository, since any sensitive credentials would get exposed.

{tip} For more information about the .env file and environment based configuration, check out the full configuration documentation.

Next Steps

Now that you have created your WpStarter project, you may be wondering what to learn next. First, we strongly recommend becoming familiar with how Laravel works by reading the following documentation: