Recipes for Drupal distributions
1 like1,134 views
This document outlines recipes for creating Drupal distributions. It discusses the anatomy of distributions, including profiles, .info files, .install files, .make files and features. It also covers testing distributions with Simpletest and continuous integration with Jenkins. Business models for distributions are proposed, including open source and customization/support. The goal is to make superb, well-tested distributions to build customizable sites on Drupal.
![projects[ctools][subdir] = "contrib"
projects[ctools][version] = "1.0-rc1"
...
projects[save_as_draft][type] = module
projects[save_as_draft][download][type] = "git"
projects[save_as_draft][subdir] = "custom"
projects[save_as_draft][download][url] =
git://github.com/druplug/save_as_draft.git
...
; Themes
projects[blogbuzz][subdir] = "contrib"
projects[blogbuzz][version] = "1.0-rc2"
...
libraries[ckeditor][download][type] = "get"
libraries[ckeditor][download][url] =
"http://ckeditor/download/source"
libraries[ckeditor][download][directory_name] =
"ckeditor"
libraries[ckeditor][download][destination] =](https://image.slidesharecdn.com/recipe-for-drupal-distributions-111112193718-phpapp02/85/Recipes-for-Drupal-distributions-28-320.jpg)
![function
bloggio_features_filter_default_formats() {
$formats = array();
// Exported format: CKEditor
$formats['ckeditor'] = array(
'format' => 'ckeditor',
'name' => 'CKEditor',
'cache' => '1',
'status' => '1',
'weight' => '0',
'filters' => array(),
);
return $formats;
}](https://image.slidesharecdn.com/recipe-for-drupal-distributions-111112193718-phpapp02/85/Recipes-for-Drupal-distributions-37-320.jpg)
Recipes for Drupal distributions
- 1. Recipes for Drupal distributions Lakshmi Narasimhan @lakshminp
- 2. Outline of this talk Chapter 0 – Intro Chapter 1 – Anotomy of a distribution Chapter 2 – So, one fine saturday afternoon... Chapter 3– Business models Chapter 4 – Now what? Questions
- 3. Chapter 0 Intro
- 4. About me Zero web programming experience until 2 years ago Initially a djangonaut started tinkering with drupal in 2010 Haven't looked back
- 5. The drupal model of a site
- 6. It's a cms
- 7. A Framework?
- 8. Platform...
- 10. So, I want to create a blog
- 11. api Daily, weekly and wysiwyg monthly archives Tag cloud CAPTCHA SEO Recent comments, recent posts etc. sitemap Media management search Backup'n Wp import restore polling
- 12. Any drupal solution which does this...
- 13. Any drupal solution which does this... Out of the box?
- 15. Custom editions of drupal
- 16. Custom editions of drupal Tuned to a desired set of features
- 17. Custom editions of drupal Tuned to a desired set of features Does one job well
- 18. Custom editions of drupal Tuned to a desired set of features Does one job well ...usually.
- 19. wiki blog Online shop videos Q&A Social network
- 20. Distributions can even be non-functional pressflow mongodb
- 21. Chapter 1 Anatomy of Drupal distributions
- 22. Distros started life in Drupal 5. Gained good momentum in 6. Improved in drupal 7.
- 23. Each distro is wrapped in a profile Profile similar to a module .info, .profile, .install, .make.
- 24. .info basic info about your distro. your module and theme dependencies. .install perform upgrades and install tasks
- 25. .profile site specific installation Ex: 1. adding a vocabulary 2. sample content 3. adding new users.
- 26. configurations to be present in site before starting to use it. core modules already imported by drupal. contrib modules. Ex:ctools, pathauto. best practice: put under "contrib" custom modules. your own modules, but not under drupal.org(yet!) best practice: put under "custom"
- 27. .make file contents:(contd) Themes, both custom and contrib. Libraries. Any other dependecies for your module. Ex:CKEditor js library for wysiwyg module.
- 28. projects[ctools][subdir] = "contrib" projects[ctools][version] = "1.0-rc1" ... projects[save_as_draft][type] = module projects[save_as_draft][download][type] = "git" projects[save_as_draft][subdir] = "custom" projects[save_as_draft][download][url] = git://github.com/druplug/save_as_draft.git ... ; Themes projects[blogbuzz][subdir] = "contrib" projects[blogbuzz][version] = "1.0-rc2" ... libraries[ckeditor][download][type] = "get" libraries[ckeditor][download][url] = "http://ckeditor/download/source" libraries[ckeditor][download][directory_name] = "ckeditor" libraries[ckeditor][download][destination] =
- 29. Features. Best way to package drupal distributions.
- 30. Features. Best way to package drupal distributions. Modular piece of functionality for a distro
- 31. Features. Best way to package drupal distributions. Modular piece of functionality for a distro All configuration is stored in code http://bit.ly/dev-staging-workflow
- 32. Some drupal entities exported by feature content types views nodes & taxonomies(using uuid) variables and settings(strongarm) user permissions text input formats <insert your fav. here>
- 33. Writing your own feature features work on a set of hooks. Each hook does a specific task towards building an exportable feature.
- 34. Feature hooks hook_features_api() defines the entity we are going to export. Ex: views.
- 35. Feature hooks hook_features_export() defines the contents of the entity we are going to export. Ex: the widget type and display options if we are exporting a field. Related dependencies.
- 36. Feature hooks hook_features_export_render() renders the exported part as code.
- 37. function bloggio_features_filter_default_formats() { $formats = array(); // Exported format: CKEditor $formats['ckeditor'] = array( 'format' => 'ckeditor', 'name' => 'CKEditor', 'cache' => '1', 'status' => '1', 'weight' => '0', 'filters' => array(), ); return $formats; }
- 38. Drush make
- 39. Drush make One step makefile for your distro
- 40. Drush make One step makefile for your distro Stub makefile
- 41. Drush make One step makefile for your distro Stub makefile profile makefile
- 42. Contrib stuff + features + drush make = distributions
- 44. testing
- 45. Things break.
- 46. Things break. Core upgrade?
- 47. Things break. Core upgrade? New version of a module
- 48. Simpletest.
- 49. simpletest modelled after simpletest php library.
- 50. simpletest modelled after simpletest php library. Part of the core in Drupal 7.
- 51. simpletest modelled after simpletest php library. Part of the core in Drupal 7. can be automated from commandline(drush).
- 52. simpletest modelled after simpletest php library. Part of the core in Drupal 7. can be automated from commandline(drush). Which begs the question....
- 53. How to automate all this?
- 54. How to automate all this? Continuous integration
- 55. Drupal + CI hook up your version control with Jenkins. (in case of github, a post receive hook.)
- 56. Drupal + CI hook up your version control with Jenkins. (in case of github, a post receive hook.) Jenkins runs the simpletest for your distro
- 57. Drupal + CI hook up your version control with Jenkins. (in case of github, a post receive hook.) Jenkins runs the simpletest for your distro you get a report of some sort.
- 58. Drupal + CI download this book. (free!). (http://www.wakaleo.com/b ooks/jenkins-the- definitive-guide)
- 59. Drupal + CI run-tests.sh is your friend. Emits junit-compatible XML, plays well with Jenkins.
- 60. Other testing ideas Coder module (http://drupal.org/project/coder ) Selenium (http://drupal.org/project/selen ium)
- 61. Site ideas + hard testing + distributions = reliable, reusable, zero config apps.
- 62. Chapter 2 So, one fine saturday afternoon...
- 63. We started an idea called Druplug.
- 64. We started an idea called Druplug. Wordpress is a platform super optimized for blogs.
- 65. We started an idea called Druplug. Wordpress is a platform super optimized for blogs. Drupal is a CMS/framework/platform which can be super optimized for wiki, blogs, forums, Q&A sites,<insert your own site pattern here>
- 66. We started an idea called Druplug. Wordpress is a platform super optimized for blogs. Drupal is a CMS/framework/platform which can be super optimized for wiki, blogs, forums, Q&A sites,<insert your own site pattern here> Some awesome distros already out there.
- 67. We want to make them better.
- 68. We want to make them better. Portmanteau of Drupal and pluggable.
- 69. We want to make them better. Portmanteau of Drupal and pluggable. Conquering the world, one distribution at a time.
- 70. We thrive on a set of visions
- 71. We thrive on a set of visions Make superb distributions
- 72. We thrive on a set of visions Make superb distributions Test, test, test.
- 73. We thrive on a set of visions Make superb distributions Test, test, test. Stick to the Drupal way.
- 74. Don't hack core. Collaboration rather than competition. Follow module writing guidelines. http://bit.ly/module-manifesto
- 76. How to make money?
- 77. The open source way Give away distributions for free.
- 78. The open source way Give away distributions for free. Build an ecosystem around it.
- 79. The open source way Give away distributions for free. Build an ecosystem around it. Themes, support, customization etc.
- 80. Examples of customization wiki with a badge system multiuser blog with affiliate management Emerging pattern: <base part> + <custom fitting>
- 81. There are other models too.
- 82. bleeding edge -> open source and free Tested and stable -> $$
- 83. Offer distributions as SaaS.
- 84. Chapter 4 Now what?
- 85. Go and build distributions.
- 86. Fork us on github. Github.com/druplug
- 87. Report bugs.
- 88. Spread the word.
- 89. Spread the word. Follow or development in twitter.
- 90. @druplug Spread the word. Follow or development in twitter.
- 91. Slides will be made available online @ lanyrd and slideshare in a while.
- 92. Thank you for having me.
- 93. ?
- 95. Colophon: made using Open office 3.2.1 on an Ubuntu. Fonts used: Purisa Franchise Inconsolata