Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Apostrophe (improved Paris edition)

9,718 views

Published on

The Apostrophe content management system. Open source, built on the Symfony framework

Published in: Technology
  • Be the first to comment

Apostrophe (improved Paris edition)

  1. 1. apostrophenow.com / punkave.com
  2. 2. A Symfony-powered CMS your clients will love Thomas Boutell
  3. 3. What is Apostrophe?Content Management SystemContent Management Framework
  4. 4. On the shoulders of giants...PHP!Symfony 1.4DoctrineMySQLZend Luceneminify ( http://code.google.com/p/minify/ )... and ideas from sfSimpleCMSPlugin
  5. 5. Goals of ApostropheEasy for clients to update without specialized trainingHard for clients to screw up by accident!Extensible by any Symfony developer
  6. 6. Making it easy"When you log in, it just gets awesomer"Do things in contextWhen you cant do things in context, keep it simpleDont require a degree in Drupal-ogy!Check it out: demo.apostrophenow.com
  7. 7. Demo #1In-context editingButton slotsMedia repositoryCroppingVersion History... All “free” when you build custom slots
  8. 8. 8
  9. 9. ... OK, but how do you extend it?Relax! Its Still Symfony (RISS)Apostrophe embraces Symfony idiomsSlot = Doctrine inheritance + Engine = Symfony module + Edit view component + aRoute & aDoctrineRoute + Normal view component + Apostrophe page as a "host" Edit action + Edit form... And layouts, and (page) templates, and plain old Symfony actions
  10. 10. Templates: adding slots and areas  <?php a_area(link, array(    area_add_content_label => Add Program,     allowed_types => array(     aButton,         ),  type_options => array(     aButton => array(       itemTemplate => homeButton,        width => 144,        // flexHeight => true,        height => 124,        // resizeType => c,        constraints => array( minimum-width => 144, minimum-height => 124,  aspect-width => 144, aspect-height => 124),         title => true,        description => false)))) ?>
  11. 11. Feed Slot: schema.ymlaFeedSlot: inheritance: extends: aSlot type: column_aggregation keyField: type keyValue: aFeed
  12. 12. Feed Slot: edit view componentclass BaseaFeedSlotComponents extends aSlotComponents{ public function executeEditView() { $this->setup(); // If this is the first validation pass make the form if (!isset($this->form)) { $this->form = new aFeedForm($this->id, $this->slot->getArrayValue()); } } ...}
  13. 13. Feed Slot: normal view component...public function executeNormalView() { $this->setup(); $this->values = $this->slot->getArrayValue(); if (!empty($this->values[url])) { $this->feed = aFeed::fetchCachedFeed( $this->url, ...); ... } }
  14. 14. Feed Slot: edit view partial<?php use_helper(a) ?><ul class="a-slot-info a-feed-info"> <li><?php echo a_(Paste an RSS feed URL, a Twitter @name (withthe @), .or the URL of a page that offers a feed. Most blogs do.) ?></li></ul><?php echo $form ?>
  15. 15. Feed Slot: normal view partial<?php use_helper(a) ?><?php if ($editable): ?> <?php // Display the edit button ?> <?php include_partial(a/simpleEditWithVariants, ... ) ?><?php endif ?><ul class="a-feed"> <?php foreach ($feed->getItems() as $feedItem): ?> <?php include_partial(aFeedSlot/.$options[itemTemplate], array(feedItem => $feedItem, ... )) ?> <?php endforeach ?></ul>
  16. 16. Feed Slot: edit actionclass aFeedSlotActions extends aSlotActions{ public function executeEdit(sfRequest $request) { $this->editSetup(); $value = $this->getRequestParameter(slot-form- . $this->id); $this->form = new aFeedForm($this->id, array()); $this->form->bind($value); if ($this->form->isValid()) { // Serialize usually better than extra db columns $this->slot->setArrayValue($this->form->getValues()); return $this->editSave(); } else { // Another validation pass return $this->editRetry(); } ...
  17. 17. Feed Slot: aFeedFormclass aFeedForm extends BaseForm{ public function __construct($id = 1, $defaults = array()) { $this->id = $id; parent::__construct(); $this->setDefaults($defaults); } public function configure() { $this->setWidget(url, new sfWidgetFormInputText( array(label => RSS Feed URL)))); // Validators for: Twitter handle, lazy URLs, // valid URLs, regular pages with feed URLs in meta tags $this->widgetSchema->setNameFormat(slot-form- . $this->id . [%s]); $this->widgetSchema->setFormFormatterName(aAdmin); }}
  18. 18. aFeedForm validators $this->setValidators(array(url => new sfValidatorAnd(array(  // @foo => correct twitter RSS feed URL new sfValidatorCallback( array(callback => array($this, validateTwitterHandle))),   // www.foo.bar => http://www.foo.bar  new sfValidatorCallback( array(callback => array($this, validateLazyUrl))),   // Must be a valid URL to go past this stage  new sfValidatorUrl( array(required => true, max_length => 1024)),   // Find feeds via meta tags in plain old pages  new sfValidatorCallback( array(callback => array($this, validateFeed)))))));
  19. 19. validateFeed: find feeds in plain pages public function validateFeed($validator, $value)  {    $content = @file_get_contents($value);    if ($content)    {      $html = new DOMDocument();      @$html->loadHTML($content);      $xpath = new DOMXPath($html);      $arts = $xpath->query(//link[@rel="alternate" and @type="application/rss+xml"]);      if (isset($arts->length) && $arts->length)      {        return $arts->item(0)->getAttribute(href);      }    }    return $value;  }
  20. 20. apostrophe:generate-slot-type FTW!./symfony apostrophe:generate-slot-type --plugin=myPlugin --type=monsterGenerates:schema.ymlActions and componentsmonsterForm class... Everything for a basic form-driven slot
  21. 21. Engines: multiple-page experiencesA Symfony module..."Grafted" into the page treeMultiple instances allowedEasy to distinguish with categorized contentExamples: Bobs blog, Janes blog, public photo gallery
  22. 22. Media engine: actions class (simplified)class BaseaMediaActions extends aEngineActions{ public function executeIndex(sfWebRequest $request) { $this->items = Doctrine::getTable(aMediaItem)->findAll(); } public function executeShow(sfWebRequest $request) { $this->item = Doctrine::getTable(aMediaItem) ->findOneBySlug($request->getParameter(slug)); }}
  23. 23. Media engine: routing (yml style)a_media_index: url: / class: aRoute param: { module: aMedia, action: index }a_media_show: url: /view/:slug class: aRoute param: { module: aMedia, action: show } requirements: { slug: ^[w-]+$ }
  24. 24. Media engine: routing examples1. /admin/media -> Engine page /admin/media Matches a_media_index route (special case for /)2. /admin/media/view/iguana -> Engine page /admin/media Matches a_media_show route, slug is iguana3. /iguanapix/view/iguana -> Engine page /iguanapix Matches a_media_show route, slug is iguana
  25. 25. Virtual pages• Any page object with a slug not starting with /• Efficiently stores slots & areas that will be needed together• ... Which is how our blog plugin works• Created on demand when you save the first slot• ... Or in advance, paired with another object (blog post)• Search treats these as routes: @blog_show?id=5, blog/show?id=5• Search ignores this: not-searchable-57• a_area(‘blog-body’, array(‘slug’ => “@blog_show?id=$id”))
  26. 26. Demo #2Various actions of the event engine pageCategory filtering (with nice URLs)Permalink pages (with nice URLs)Some nice features of the blog (and event) pluginVirtual pages for blog and event contentThe feed slot does its magic
  27. 27. 27
  28. 28. Too friendly?• “If it’s friendly it must be for small sites”• More users = more training?• Can you afford to train 100 people?• Less training required = more scalable
  29. 29. Demo #3: features for big sites• Access controls• Reorganizing the page tree
  30. 30. 30
  31. 31. Bonus: safe, efficient JS calls + minifierlayout.php:<head><?php a_use_javascripts() ?><?php a_use_stylesheets() ?></head><body>... At the very END of the body:<?php a_include_js_calls() ?></body>_list_footer.php:<?php a_js_call(apostrophe.enableUserAdmin(?), array(choose-one-label => a_(Choose One...))); ?>
  32. 32. Apostrophe 2.0
  33. 33. Apostrophe 2.0
  34. 34. Apostrophe 2.0
  35. 35. Apostrophe 2.0
  36. 36. Apostrophe 2.0
  37. 37. Apostrophe 2.0
  38. 38. Apostrophe 2.0
  39. 39. Conclusions1.5 is awesome now2.0 will be awesome laterYou are awesomeLets be awesome together
  40. 40. apostrophenow.com apostrophenow.com
  41. 41. http://joind.in/view/talk/2744 apostrophenow.com

×