Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/salaros/mr-press

Mr. Press is a WordPress development stack similar to Bedrock. Project's main goal is to improve the overall security, portability and deployment process of WordPress, while trying to use the best web development practices.
https://github.com/salaros/mr-press

bedrock composer theme timber wordpress wordpress-deployment wordpress-development wordpress-installation wordpress-plugin wordpress-theme wp-cron

Last synced: 3 months ago
JSON representation

Host: GitHub
URL: https://github.com/salaros/mr-press
Owner: salaros
License: mit
Created: 2015-06-29T23:16:34.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2017-11-28T17:16:40.000Z (about 7 years ago)
Last Synced: 2024-08-21T16:31:39.355Z (4 months ago)
Topics: bedrock, composer, theme, timber, wordpress, wordpress-deployment, wordpress-development, wordpress-installation, wordpress-plugin, wordpress-theme, wp-cron
Language: PHP
Homepage:
Size: 167 KB
Stars: 4
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

        # Mr. Press

[![Latest Stable Version](https://poser.pugx.org/salaros/mr-press/v/stable)](https://packagist.org/packages/salaros/mr-press)

[![Packagist type](https://img.shields.io/badge/Packagist-library-pink.svg)](https://packagist.org/packages/salaros/mr-press)

[![Packagist downloads](https://img.shields.io/packagist/dt/salaros/mr-press.svg)](https://packagist.org/packages/salaros/mr-press/stats)

[![License](https://poser.pugx.org/salaros/mr-press/license)](https://packagist.org/packages/salaros/mr-press)

[![Gitter](https://badges.gitter.im/Mr-Press/Lobby.svg)](https://gitter.im/Mr-Press/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge)

[![SensioLabs Insight](https://img.shields.io/sensiolabs/i/5e21fcee-41e1-4e12-82c6-c1a4549c44a2.svg)](https://insight.sensiolabs.com/projects/5e21fcee-41e1-4e12-82c6-c1a4549c44a2)

[![Build Status](https://scrutinizer-ci.com/g/salaros/mr-press/badges/build.png?b=master)](https://scrutinizer-ci.com/g/salaros/mr-press/build-status/master)

[![Dependency Status](https://www.versioneye.com/user/projects/57bfee1d69d9490042f72c31/badge.svg?style=flat-square)](https://www.versioneye.com/user/projects/57bfee1d69d9490042f72c31)

[![composer.lock](https://poser.pugx.org/salaros/mr-press/composerlock)](https://packagist.org/packages/salaros/mr-press)

**Mr. Press** is a [WordPress](https://wordpress.org/) development stack similar to [Bedrock](https://github.com/roots/bedrock).

Project's main goal is to improve the overall security, portability and deployment process of WordPress, while trying to use the best web development practices.

## Features

* WordPress, its themes and plugins are installed and updated via Composer!

* `wp-content` folder has been relocated, so it won't mess up with WordPress core

* Critical WordPress settings (such as site URL, database credentials etc) are [loaded from the environment variables](http://12factor.net/config)

* [WP Cron is disabled](https://www.lucasrolff.com/wordpress/why-wp-cron-sucks/) by default and there is a ready-to-use cron job to run

### Mr. Press default theme's features

* [Bootstrap](http://getbootstrap.com/) responsive layout

* Clean templates using [Twig](http://getbootstrap.com/) templates via [Timber](http://twig.sensiolabs.org/) plugin

* A lot of customizations can be done directly from code:

    * define menus (links to page, custom links, nested items etc)

    * add / remove custom post types and taxonomies

    * handy access to [Bower](http://bower.io/) and [NPM](https://www.npmjs.com/package/npm-assets) assets

* Integration with [Advanced Custom Fields](http://www.advancedcustomfields.com) plugin (group fields can be registered from theme code) and used via Timber

## Requirements

* [PHP](http://php.net/) >= 5.5 or 7.0

* [Apache](https://httpd.apache.org/) or [NGINX](http://nginx.org/en/) web server

* [MySQL](https://www.mysql.com/) or [MariaDB](https://mariadb.org/) DB server

* [Composer](https://getcomposer.org/) >= 1.0

Make sure that Composer and the rest of the requirements are installed.

## Installation

Just go the web root folder (usually it's `/var/www`) and create your copy of the project:

``` bash

$ cd /var/wwww

$ composer create-project salaros/mr-press my-new-website

```

### Create WordPress tables

Now change to `/var/www/my-new-website` directory and edit the `.env` file and chnage DB connection settings and site URL:

``` bash

$ cd /var/www/my-new-website

$ editor .env

$ composer run-script initialize

```

### Create cron job

Since [WP Cron is disabled](https://www.lucasrolff.com/wordpress/why-wp-cron-sucks/) by default you'd better run the commands below in order to enable a system [cron job](https://en.wikipedia.org/wiki/Cron) which triggers WP Cron every 5 min:

*PLEASE NOTE: `create-cron-job` requires administrator privileges, so you should run it as root ([super user](https://en.wikipedia.org/wiki/Superuser)) or [sudoer user](https://help.ubuntu.com/community/Sudoers).*

``` bash

$ cd /var/www/my-new-website

$ composer run-script create-cron-job

```

## Contributing

1. Fork it: `https://github.com/salaros/mr-press`

2. Create your feature branch: `git checkout -b my-new-feature`

3. Commit your changes: `git commit -am 'Add some feature'`

4. Push to the branch: `git push origin my-new-feature`

5. Submit a pull request :bear:

## Known bugs

* **Mr. Press** has been tested on Linux and might also work correctly on Mac OS X. Windows compatibility will be implemented later

* Most likely **Mr. Press** is not compatible with WordPress multisie, but this feature has been already added to the RoadMap

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

## Credits

TODO: Write credits