Project

• What is the Clean Markup Module?

  • Allows a site administrator to configure the markup spit out by blocks and panels.
  • Submit feature requests and patches for other modules!

• What does the module actually do?

  • Blocks:
    • On the block configuration page, there's a vertical tab with options for customizing the markup. e.g.:
      • Disable or set the HTML5 element to use as the block wrapper,
      • Enable or disable an inner div,
      • Add classes to the outer block element,
      • Add custom attributes (i.e. role="navigation")
      • Set the HTML5 element to wrap the title,
      • Toggle whether the block title is displayed visually,
      • Disable or set the HTML5 element to wrap the content.
  • Panels
    • Provides a pane style with similar markup options as the blocks.
    • Provides a region style with similar markup options as the blocks and panes.
      • Also lets you enable or disable separator divs between panes in the region.
    • Provides four clean panel layouts.
      • One Column Clean: one region and single wrapper.
      • One Column Reset: one region with no wrapper.
      • Six pack: six regions.
      • Myriad: five rows with four regions each that will output the absolute minimum markup. For example, a row with only one region will not output the row wrapper.

• Where does it fit in with other modules?

  • Complements Display Suite
    • DS lets you customize node, user layouts.
  • Complements Fences.
    • Served as an inspiration to our module.
    • Really early on, our module was going to be a patch to Fences.
    • Fences deals exclusively with fields though.
  • Complements Mothership
    • Great HTML reset theme
    • Problem is that if you want to customize HTML element for a particular block, say, you have to write it's own theme files — on a site with lots of blocks, that gets unwieldy.
  • Semantic panels
    • Actually didn't know of this project originally.
    • Disclaimer: Have not used or worked with it.
    • Pretty similar to the panels part of our module.
    • Quick glance over the settings form suggests it provides fewer points of customization.
    • Have filed an issue to collaborate with them.

• What's the future of the module?

  • Plan to support views.
    • Semantic views - it lets you customize the field and row wrappers, but doesn't support customizing view-header, view-content, view-footer regions and the view wrapper itself.

Use Cases

• Is this best utilized during the initial development phase?
• How easy is it to retrofit it into an existing site?

NodeSquirrel (Unofficial Sponsor)

I mentioned NodeSquirrel in this episode, and that I would share a coupon code for them. So, here it is, exclusively for listeners of the Modules Unraveled Podcast:
Use "StartToGrow" it's a 12-month free upgrade from the Start plan to the Grow plan. So, using it means that the Grow plan will cost $5/month for the first year instead of $10. (10 GB storage on up to 5 sites)