WordPress with an better ecosystem

dev-master 2017-10-01 19:39 UTC



WaffleStack Survival Guide

First Things First

Welcome. WordPress is a nice extensible and extensive software. Because they're so many people working on it, the code is not as nice as the UI... (no offense 😉). That's the reason why I started the work on WaffleStack. My goal is building a WordPress with an better ecosystem which bases on PSR, composer autoloading and uses a template engine etc. Anyone is welcome to contribute to WaffleStack.

Note: Since this is a hard fork, there is no git log from the original repository.
WaffleStack bases on the original source (Tag v4.8 but changes from 4.8.2 are merged)

— Julian Finkler


Currently there are 2 branches: dev and master. The dev branch is updated daily and might be not stable. dev is weekly merged into master. You could say that the master is a 'weekly build'.

Installation: Famous 10-minute install

  1. Clone the repository
  2. Run $ composer install --no-dev --optimize-autoloader
  3. Tell your http server, the web root is /web
  4. Open wp-admin/install.php in your browser. It will take you through the process to set up a wp-config.php file with your database connection details.
    1. If for some reason this doesn't work, don't worry. It doesn't work on all web hosts. Open up wp-config-sample.php with a text editor like WordPad or similar and fill in your database connection details.
    2. Save the file as wp-config.php and upload it.
    3. Open wp-admin/install.php in your browser.
  5. Once the configuration file is set up, the installer will set up the tables needed for your blog. If there is an error, double check your wp-config.php file, and try again. If it fails again, please go to the support forums with as much data as you can gather.
  6. If you did not enter a password, note the password given to you. If you did not provide a username, it will be admin.
  7. The installer should then send you to the login page (wp-login.php). Sign in with the username and password you chose during the installation. If a password was generated for you, you can then click on "Profile" to change the password.

Note: Later I will provide a complete build for download, that you have only upload it to your server.


WaffleStack actually does not support auto updating.

Tips & Tricks

Look in the docs/ Folder 🙂

System Requirements

  • PHP version 5.6 or higher.
  • MySQL version 5.0 or higher.


  1. PHP version 7 or higher.
  2. MySQL version 5.6 or higher.
  3. The mod_rewrite Apache module.
  4. HTTPS support.


WaffleStack is free software, and is released under the terms of the GPL version 2 or (at your option) any later version. See LICENSE.md.