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 Listhttps://drupal.org/list-change

Examples for Developershttps://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

PSR-0

NamespaceDrupal\custom_block\Plugin\Block

File Locationlib/Drupal/custom_block/Plugin/Block/CustomBlockBlock.php

Resources

Drupal.org Change Listhttps://drupal.org/list-change

D7 to D8 upgrade tutorial: Pants modulehttps://drupal.org/node/1911346

Webchick's Bloghttp://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 moduleshttps://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!

Markdown support

For those of you who like that sort of thing. Instructions and a bit more info available here.

<section data-markdown>
  ## Markdown support

  For those of you who like that sort of thing.
  Instructions and a bit more info available [here](https://github.com/hakimel/reveal.js#markdown).
</section>

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 This slide has fragments which are also stepped through in the notes window.

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.

Stellar Links

THE END

BY Hakim El Hattab / hakim.se