Upgrading Modules to Drupal 8
DrupalCorn 2013
About Me
Will Long
@Kerasai
Kerasai on D.O- http://kerasai.com
Objectives
- Highlight significant changes to Drupal's API.
- Identify new patterns used to develop in Drupal 8.
- Leave maintainers able to upgrade modules.
Agenda
- Basics
- PSR-0 & Namespaces
- Configuration System
- Blocks & Plugins
- Menu/Routing System
- Twig & Theme Hooks
Now is the Time to Upgrade
API Freeze
July 1, 2013
Now is the Time to Upgrade
Polish Phase
July 1, 2013 - TBD
#D8CX
The Contrib Experience
Encourage early adoption of Drupal 8 by getting the 40 most popular contrib modules ported to D8.
Test-driven Upgrades
Most Useful Slide
Drupal.org Change List
https://drupal.org/list-change
Examples for Developers
https://drupal.org/project/examples
Basics
Where do I put this thing?
- Core modules moved to core/modules directory.
- Contrib modules may be installed into modules directory, or sites/*/modules.
Register Your Module
Drupal 7
modules/field/modules/text/text.info
Register Your Module
Drupal 8
core/modules/text/text.info.yml
Resources
Drupal.org Change List
https://drupal.org/list-change
D7 to D8 upgrade tutorial: Pants module
https://drupal.org/node/1911346
Webchick's Blog
http://webchick.net/upgrade-modules-d8
Contribute
Contributing isn't all about developing core or writing contrib modules. You can help out by creating and updating documentation on Drupal.org. Please.
Creating Drupal 8.x modules
https://drupal.org/node/1915030
Vertical Slides
Slides can be nested inside of other slides, try pressing down.
Basement Level 1
Press down or up to navigate.
Basement Level 2
Cornify
Basement Level 3
That's it, time to go back up.
Slides
Not a coder? No problem. There's a fully-featured visual editor for authoring these, try it out at http://slid.es.
Point of View
Press ESC to enter the slide overview.
Hold down alt and click on any element to zoom in on it using zoom.js. Alt + click anywhere to zoom back out.
Works in Mobile Safari
Try it out! You can swipe through the slides and pinch your way to the overview.
Marvelous Unordered List
- No order here
- Or here
- Or here
- Or here
Fantastic Ordered List
- One is smaller than...
- Two is smaller than...
- Three!
Transition Styles
You can select from different transitions, like:
Cube -
Page -
Concave -
Zoom -
Linear -
Fade -
None -
Default
Themes
Reveal.js comes with a few themes built in:
Sky -
Beige -
Simple -
Serif -
Night -
Default
* Theme demos are loaded after the presentation which leads to flicker. In production you should load your theme in the <head> using a <link>.
Global State
Set data-state="something" on a slide and "something"
will be added as a class to the document element when the slide is open. This lets you
apply broader style changes, like switching the background.
Custom Events
Additionally custom events can be triggered on a per slide basis by binding to the data-state name.
Reveal.addEventListener( 'customevent', function() {
console.log( '"customevent" has fired' );
} );
Slide Backgrounds
Set data-background="#007777" on a slide to change the full page background to the given color. All CSS color formats are supported.
Image Backgrounds
<section data-background="image.png">Repeated Image Backgrounds
<section data-background="image.png" data-background-repeat="repeat" data-background-size="100px">Background Transitions
Pass reveal.js the backgroundTransition: 'slide' config argument to make backgrounds slide rather than fade.
Background Transition Override
You can override background transitions per slide by using data-background-transition="slide".
Clever Quotes
These guys come in two forms, inline:
“The nice thing about standards is that there are so many to choose from”
and block:
“For years there has been a theory that millions of monkeys typing at random on millions of typewriters would reproduce the entire works of Shakespeare. The Internet has proven this theory to be untrue.”
Pretty Code
function linkify( selector ) {
if( supports3DTransforms ) {
var nodes = document.querySelectorAll( selector );
for( var i = 0, len = nodes.length; i < len; i++ ) {
var node = nodes[i];
if( !node.className ) ) {
node.className += ' roll';
}
};
}
}
Courtesy of highlight.js.
Intergalactic Interconnections
You can link between slides internally, like this.
Fragmented Views
Hit the next arrow...
... to step through ...
any type- of view
- fragments
Fragment Styles
There's a few styles of fragments, like:
grow
shrink
roll-in
fade-out
highlight-red
highlight-green
highlight-blue
Spectacular image!
Export to PDF
Presentations can be exported to PDF, below is an example that's been uploaded to SlideShare.
Take a Moment
Press b or period on your keyboard to enter the 'paused' mode. This mode is helpful when you want to take distracting slides off the screen during a presentation.