Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MarikaKononen/CodeForMyLife
WordPress blog - DustPress
https://github.com/MarikaKononen/CodeForMyLife
Last synced: 3 months ago
JSON representation
WordPress blog - DustPress
- Host: GitHub
- URL: https://github.com/MarikaKononen/CodeForMyLife
- Owner: MarikaKononen
- License: mit
- Created: 2020-04-03T19:52:59.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-05T13:01:02.000Z (almost 2 years ago)
- Last Synced: 2024-04-03T14:33:30.148Z (7 months ago)
- Language: PHP
- Size: 18.3 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Geniem WordPress Project template.
[](https://travis-ci.org/devgeniem/wp-project)
Use this as a local development environment with our docker-image: [devgeniem/ubuntu-docker-wordpress-development](https://github.com/devgeniem/ubuntu-docker-wordpress-development).
And our development tools: [gdev](https://github.com/devgeniem/gdev).
## Features
- This resembles [roots/bedrock](https://github.com/roots/bedrock) project layout.
- Uploads directory has been moved into /var/www/uploads (locally mapped into .docker/uploads)
- Uses composer for installing plugins
- Include `.drone.yml` for using [Drone CI](https://github.com/drone/drone).
- Includes phantomjs tests through rspec for doing integration testing. Source: [Seravo/wordpress](https://github.com/Seravo/wordpress).
- Custom Nginx includes and env templating nginx configs
## Workflow for WP projects
1. After you have cloned this repository in the new client project replace all `THEMENAME` and `PROJECTNAME` references from all files from this project to your project name.
* These can be for example: `ClientName` and `client-name`
2. Change project test address in `docker-compose.yml` for example `asiakas.test` -> `client-name.test`
3. Add all people working in the project into `authors` section of `composer.json` and rename the project `devgeniem/wp-project`->`devgeniem/client` in `composer.json`.
* You can also add project managers, designers and other developers here.
* This is important so that we always have accountable people to advise with the project later on when it eventually might turn to more legacy project.
4. Setup minimun viable content seed in phinx seeds so that CI can reliably do the tests.
* modify `scripts/seed.sh` script and add `sphinx` seed data, `.sql` dump file or custom wp cli commands.
5. Use included linters for the code style and best practises
* We use `php codesniffer` with custom config in `phpcs.xml` which contains Geniem Coding Standards.
* This ruleset is here to help and make the developer to think about possible vulnerabilities.
* When something doesn't fit into the ruleset you can ask for a code review and add comments to ignore certain line:
```php
// @codingStandardsIgnoreStart
$query_string = filter_var($_SERVER['QUERY_STRING'], FILTER_SANITIZE_STRING)
// @codingStandardsIgnoreEnd
```
6. If you are using Flynn replace the application name in `.drone.yml` -> `FLYNN_APP`
7. Add more `rspec` or `phpunit` tests while you continue to add features to your site.
* This helps us to avoid regressions and will enable more agile refactoring of the code when needed.
8. Update this Readme as many times as you can.
* Most important details are usually the details about data models and their input/output.
* Also add all 3rd-party dependencies here
9. Replace `BASIC_AUTH_USER` and `BASIC_AUTH_PASSWORD_HASH` from `Dockerfile` with real credentials.
* You can find more info about formats here: http://nginx.org/en/docs/http/ngx_http_auth_basic_module.html
* For example you can generate password hash with: `$ openssl passwd -crypt "password"`
10. Add slack notifications from builds by replacing `wp-team` channel to your slack channel.
11. Define performance budget for this project by defining metrics into `tests/sitespeed-budget.json`.
* When this project grows older always try to keep same performance and avoid changes which undermine the original performance goals.
## IDE Support
We have preconfigured PhpStorm settings available in: https://github.com/devgeniem/wp-project-phpstorm-settings. These will be automatically installed when you run `$ make init`.
## Start local development
This project includes example `docker-compose.yml` which you can use to develop locally. Ideally you would use [gdev](https://github.com/devgeniem/gdev).
Propably the easiest way to start is to run:
```
$ make init
```
This starts the local development environment, installs packages using composer, builds project assets and seeds the database.
## Testing
You can run the php codesniffer, rspec and sitespeed tests by using the Makefile:
```
$ make test
```
Open the url you provided in step 2 for example: `client-name.test` and start developing the site.
## Google cloud build
The project base provides templates to build/test/deploy the project via Google Cloud Build (GCB) to Kontena.
Google cloud CI/CD is configured by the yaml files in `gcloud/`. There are separate config files to configure staging and production enviroments.
(This assumes it's a Geniem project. For other projects you need to also replace all the secrets as documented by Google)
To enable a build pipeline, do following:
1. Replace PROJECTNAME and THEMENAME in the yaml files (gdev does this in the future).
2. Replace mentions of `asiakas` in the yaml files, including `tests/acceptance.suite.yml` and the Kontena files (gdev does this in the future).
3. Uncomment webpack/phpcs/integration test steps as needed
-- Integration tests is still work in progress
-- Configure them in `tests/` if enabling
4. Create build triggers to GCB
-- Trigger from push to branch or tag in Github
-- Build configuration type: cloudbuild.yaml.
-- Set location as `gcloud/cloudbuild_stage.yaml` or `gcloud/cloudbuild_production.yaml`
5. Run the build once to store image in gcr.io
6. Install Kontena stack.
Further description is located in `gcloud/README.md`
## Changelog
[CHANGELOG.md](/CHANGELOG.md)
## Environment variables
The project uses environment variables to define settings for WordPress. *This is not a complete list and will be completed in the future!*
### WP_BLOG_PUBLIC
This environment variable controls the WordPress `blog_public` [option](https://codex.wordpress.org/Option_Reference#Privacy) via the [WP Readonly Options](https://github.com/devgeniem/wp-readonly-options) plugin.
**Values**
- `1` *(integer) (default)* I would like my blog to be visible to everyone, including search engines.
- `0` *(integer)* I would like to block search engines, but allow normal visitors.
## Composer dependencies' descriptions
```
# List of used repositories:
## WPACKAGIST - the main repo for WordPress plugins.
"type": "composer",
"url": "https://wpackagist.org"
## Koodimonni's repo for ḱeeping WP language packets up-to-date through composer
"type": "composer",
"url": "https://wp-languages.github.io"
------------------------------------------------
------------------------------------------------
# List of used plugins / vendor packets
## Minimun php version
"php": ">=7.0"
## WordPress as a composer dependency
"johnpbloch/wordpress": ">=4.5.0"
## Loads environment variables from .env to getenv() to be used in project configs.
"vlucas/phpdotenv": "^2.0.1"
## Also loads the environment variables. Why is this needed?
"oscarotero/env": "^1.0"
## We're able to specify different paths for packages with this. WP plugins, for example, are installed to web/app/plugins with the help of this package.
"composer/installers": "v1.0.12"
## We use this to be able to install Koodimonni's language packets via composer. With this installer we can install multiple packets to one folder. We can also install our object-cache-dropin to its needed path with this.
"koodimonni/composer-dropin-installer": ">=1.0"
## Finnish language for WordPress via Composer
"koodimonni-language/core-fi": "*"
## A collection of plugins and dropins that simplify the wp and add security to it. The list can be seen here: https://github.com/devgeniem/wp-safe-fast-and-clean-collection/blob/master/composer.json
"devgeniem/wp-safe-fast-and-clean-collection": ">=1.0"
## Adds a prettier database connection error page.
"devgeniem/better-wp-db-error": ">=0.1"
## Sets robots.txt according to given envinronment variables from the config.
"devgeniem/wp-noindex-testing-staging-robots": "^1.0"
## This is used for creating seeds for projects with many developers. The seed is also used for CI tests.
"robmorgan/phinx": "^0.5.3"
## This is used to monitor actions made by different users of the WP admin.
"wpackagist-plugin/stream": ">=3.2.0",
## This is used to enhance the capabilities of the WP default media library. With this we can for example categorize the added media items.
"wpackagist-plugin/enhanced-media-library": ">=2.4.4",
## The geniem redis object cache dropin package. This is installed under /app so that WP uses it instead of its own object cache file.
"devgeniem/wp-redis-object-cache-dropin": ">=1.3.4"
## Whoops debugging for WordPress
"rarst/wps": ">=1.0.0"
# List of plugin and dropin paths
## Custom paths for packages of certain types, e.g. wordpress plugins.
"installer-paths": {
"web/app/mu-plugins/{$name}/": ["type:wordpress-muplugin","rarst/wps"],
"web/app/plugins/{$name}/": ["type:wordpress-plugin"],
"web/app/themes/{$name}": ["type:wordpress-theme"]
}
## Custom paths for Koodimonni's dropin-installer
"dropin-paths": {
"web/app/": ["type:wordpress-dropin"],
"web/app/languages/": ["vendor:koodimonni-language"],
"web/app/languages/plugins/": ["vendor:koodimonni-plugin-language"],
"web/app/languages/themes/": ["vendor:koodimonni-theme-language"]
}
## WP itself goes here
"wordpress-install-dir": "web/wp"
```