Using Composer to create manageable WordPress websites
1 like1,253 views
The document discusses using Composer to manage WordPress website development, highlighting its capabilities in dependency management and project organization. It outlines the installation process, structure of the composer.json file, and finding compatible packages. Additionally, it addresses common queries regarding version control, project structure, and best practices for managing WordPress-specific dependencies.
![Composer.json?
$ composer init
{
"name": "foralien/my_pack",
"description": "Test package",
"authors": [
{
"name": "Anna Ladoshkina",
"email": "webdev@foralien.com"
}
],
"require": {}
}](https://image.slidesharecdn.com/wceu-ladoshkina-using-composer-160626061906/85/Using-Composer-to-create-manageable-WordPress-websites-8-320.jpg)
![…or specify them all in composer.json
"repositories": [
{
"type": "composer",
"url" : "http://some-packagist.org"
},
{
"type": "vcs",
"url": "https://github.com/username/repo"
},
{
"type": "artifact",
"url": "local_folder/"
}
],
"require" : {
"author/package": "1.0",
"another_author/package" : "4.4"
}
More on composer.json schema: https://getcomposer.org/doc/04-schema.md](https://image.slidesharecdn.com/wceu-ladoshkina-using-composer-160626061906/85/Using-Composer-to-create-manageable-WordPress-websites-12-320.jpg)
![Add them into composer.json
"repositories": [
{
"type": "composer",
"url" : "http://wpackagist.org"
},
{
"type": "composer",
"url": "http://wp-languages.github.io"
},
]](https://image.slidesharecdn.com/wceu-ladoshkina-using-composer-160626061906/85/Using-Composer-to-create-manageable-WordPress-websites-30-320.jpg)
![Paths in composer.json
"config" : {
"vendor-dir": "wp-content/vendor",
},
"extra" : {
"wordpress-install-dir": "core",
"dropin-paths": {
"wp-content/languages/":
["vendor:koodimonni-language"]
}
}](https://image.slidesharecdn.com/wceu-ladoshkina-using-composer-160626061906/85/Using-Composer-to-create-manageable-WordPress-websites-32-320.jpg)
Using Composer to create manageable WordPress websites
- 1. Using Composer to create manageable WordPress websites Anna Ladoshkina WordCamp Europe, 24/06/2016
- 2. I’ve been making websites for NGOs for 7 years @foralien bureau / Teplitsa. Technologies for social good
- 3. You may need it if… You are developing websites on PHP (with WordPress) You would like to use modern development tool You would like to have more organized projects You would like to start easily You hear that buzzword all the time, but…
- 5. What’s dependency? Suppose: You have a project that depends on a number of libraries. Some of those libraries depend on other libraries. Composer: Enables you to declare the libraries you depend on. Finds out versions of packages and installs them (into your project)
- 7. How to install? PHP 5.3.x and command line Follow instruction at https://getcomposer.org/doc/00-intro.md Add composer.json to the project folder
- 8. Composer.json? $ composer init { "name": "foralien/my_pack", "description": "Test package", "authors": [ { "name": "Anna Ladoshkina", "email": "[email protected]" } ], "require": {} }
- 9. Where to find packages? Composer-specific repositories https://packagist.org/ GitHub (other open-source repositories) https://github.com/ Create yourself author/package_name
- 10. packagist.org
- 11. Add them one by one… $ composer config repositories.foo vcs https://github.com/foo/bar $ composer require package More on command-line interface: https://getcomposer.org/doc/03-cli.md
- 12. …or specify them all in composer.json "repositories": [ { "type": "composer", "url" : "http://some-packagist.org" }, { "type": "vcs", "url": "https://github.com/username/repo" }, { "type": "artifact", "url": "local_folder/" } ], "require" : { "author/package": "1.0", "another_author/package" : "4.4" } More on composer.json schema: https://getcomposer.org/doc/04-schema.md
- 14. Have some coffee and check /vendor folder
- 17. Common WordPress website project - core files - wp-config.php - wp-content/plugins - wp-content/themes - wp-content/languages - wp-content/uploads
- 18. A few questions to ask What should be under version control? - What are dependencies? - Where are Composer-compatible repositories? - What to do with vendor folder?
- 19. Give me an example https://roots.io/ Bedrock - WordPress boilerplate http://composer.rarst.net Unofficial companion to Composer documentation for WordPress developers
- 20. Step by step
- 21. Core is dependency plugins languages themes What are dependencies?
- 22. Tune project structure WordPress in subfolder https://codex.wordpress.org/ Giving_WordPress_Its_Own_Directory Move wp-content folder https://codex.wordpress.org/ Editing_wp-config.php#Moving_wp- content_folder
- 23. In settings
- 24. In wp-config.php define( 'WP_CONTENT_DIR', dirname(__FILE__) . '/wp-content' ); define( 'WP_CONTENT_URL', '//domain.com/wp-content' );
- 25. WordPress specific repositories core plugins languages Where are Composer-compatible repositories?
- 26. WordPress core at https://packagist.org/
- 29. Local folder /artifacts myproject/myplugin-2.0.zip — plugins code — composer.json
- 30. Add them into composer.json "repositories": [ { "type": "composer", "url" : "http://wpackagist.org" }, { "type": "composer", "url": "http://wp-languages.github.io" }, ]
- 31. Config custom paths for dependencies core plugins languages What to do with vendor folder?
- 32. Paths in composer.json "config" : { "vendor-dir": "wp-content/vendor", }, "extra" : { "wordpress-install-dir": "core", "dropin-paths": { "wp-content/languages/": ["vendor:koodimonni-language"] } }
- 33. Finally add dependencies into…
- 34. …require or requires-dev sections "require" : { "composer/installers" : "~1.0", "johnpbloch/wordpress" : ">=4.4", "wpackagist-plugin/wordpress-seo" : "@stable", "koodimonni-language/core-ru_ru" : "*" , "myproject/myplugin" : "2.0", }, "require-dev" : { "wpackagist-plugin/menu-exporter" : "@stable", "wpackagist-plugin/wordpress-importer" : "@stable" }
- 37. @foralien bureau / foralien.com Thank you Anna Ladoshkina www.facebook.com/anna.ladoshkina [email protected]