Initial commit

motivast · May 9, 2019 · 51be1f6 · 51be1f6
commit 51be1f6
Show file tree

Hide file tree

Showing 50 changed files with 12,516 additions and 0 deletions.
diff --git a/.distignore b/.distignore
@@ -0,0 +1,39 @@
+# Dotfiles
+.*
+
+# Executable
+bin
+
+# Packages
+composer.json
+composer.lock
+package.json
+package-lock.json
+yarn.lock
+
+# Libraries
+node_modules
+vendor
+
+# Assets
+assets
+
+# Configuration
+rules
+tasks
+phpunit.xml
+build.xml
+
+# Tests
+tests
+
+# Build
+build
+svn
+
+# Docker
+docker
+docker-compose.yml
+
+# I do not know from where this directory is getting from?
+etc
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,25 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+# WordPress Coding Standards
+# http://make.wordpress.org/core/handbook/coding-standards/
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = tab
+
+[*.yml]
+indent_size = 4
+indent_style = space
+
+[*.json]
+indent_size = 2
+indent_style = space
+
+[*.txt,wp-config-sample.php]
+end_of_line = crlf
diff --git a/.env.example b/.env.example
@@ -0,0 +1,22 @@
+
+###
+# WordPress config variables
+###
+WP_CONFIG_DB_NAME=wordpress
+WP_CONFIG_DB_USER=wordpress
+WP_CONFIG_DB_PASS=secret
+WP_CONFIG_DB_HOST=database
+
+WP_CONFIG_EXTRA="define('WP_DEBUG', true); define('AUTOSAVE_INTERVAL', '3600'); define('WP_POST_REVISIONS', false);"
+
+###
+# WordPress installation variables
+###
+WP_VERSION=5.1
+WP_LOCALE=en_US
+WP_PATH=./wordpress
+WP_URL=http://localhost:8080
+WP_TITLE="Mizar"
+WP_ADMIN_USER=mizar
+WP_ADMIN_PASS=mizar
+WP_ADMIN_EMAIL=mizar@example.com
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,25 @@
+# Ignore .env files
+.env
+
+# Ignore wordpress itself
+wordpress
+
+# Ignore vendor lib
+vendor
+node_modules
+
+# Ignore generated assets
+css
+js
+img
+fonts
+
+# Ignore build
+build
+
+# Reports
+coverage
+clover.xml
+
+# Leftovers
+.checksums
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,99 @@
+# Contribution guide
+I’m really excited that you are interested in contributing to Mizar. Before submitting your contribution though, please make sure to take a moment and read through the following guidelines.
+
+## Development setup
+
+### Clone project
+```
+git clone git@gitlab.com:motivast/mizar.git
+cd mizar
+```
+
+### Copy dotenv and fill with your properties
+```
+cp .env.example .env
+```
+
+### Install dependencies
+```
+composer install
+```
+During installation WordPress is downloaded to wordpress directory and current directory is self symlinked to wordpress/wp-content/plugins. Pointing your webserver vhost to wordpress directory give you fully working WordPress instance with Mizar WordPress plugin installed.
+
+### Setup WordPress
+```
+./vendor/bin/phing wp:init
+```
+
+This command will install WordPress with configuration from .env file. After installation you should have fully working WordPress instance with Mizar WordPress plugin activated.
+
+### Code inspection and tests
+Be sure to execute code inspection and test before before making a pull request.
+```
+./vendor/bin/phing inspect tests
+```
+
+## Commit message guidelines
+A well-structured and described commit message helps better maintain open source project.
+
+* current developers and users can quickly understand what new changes are about
+* future developers have a clear history of changes in the code
+* changelog is automatically generated from commit messages
+
+Commit message is divided into sections **type**, **scope**, **subject**, **body**, **footer**. Only **type** and **subject** are required.
+
+```
+<type>(<scope>): <subject>
+<BLANK LINE>
+<body>
+<BLANK LINE>
+<footer>
+```
+
+Commit message header **type**, **scope**, **subject** should not be longer than 72 chars.
+
+### Type
+Type describe what type of changes commit message introduces. You can choose from the following types:
+
+* **build**: Changes that affect the build system or external dependencies (example scopes: composer, npm, phing, gulp)
+* **ci**: Changes to our CI configuration files and scripts (example scopes: travis)
+* **docs**: Documentation only changes
+* **feat**: A new feature
+* **fix**: A bug fix
+* **perf**: A code change that improves performance
+* **refactor**: A code change that neither fixes a bug or adds a feature
+* **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
+* **test**: Adding tests or correcting existing tests
+
+If the prefix is `feat`, `fix` or `perf`, it will appear in the changelog. However, if there is any `BREAKING CHANGE`, the commit will always appear in the changelog.
+
+### Scope
+Scope describes which part of the code is affected by changes. There are no strict rules on what values scope can accept.
+
+### Subject
+Subject contains a short and concise description of changes in the code. Use the following rules to create subject:
+* always start from capital letter
+* do not end subject line with a period `.`
+* start from keyword like "Add", "Fix", "Change", "Replace"
+* use the imperative mode, "Fix bug" not "Fixed bug" or "Fixes bug"
+
+### Body
+The body contains a long description of changes in the code. As in the subject, use the imperative mode. Please write why changes to the code were required and how changes affect the behavior of the software compared to the previous version.
+
+### Footer
+
+#### Breaking changes
+All breaking changes have to be included in the footer and start with `BREAKING CHANGE:`. Point which parts of the API have been changed and write an example of how API was used `before` changes and how should be used `after`. Also, provide a description how to migrate from previous to next version.
+
+#### Referring to issues
+If commit closes some issues please refer them in the footer from the beginning of the new line.
+
+```
+Closes #123
+```
+
+or in case of many issues
+
+```
+Closes #123, #234, #345
+```