Hacking Movable Type Training - Day 2

Hacking Movable Type Day 2 A guide for developers Six Apart Ltd. Page 

Review • Day 1: The Basics – Plugin Structure – The Registry – ConﬁguraBon DirecBves – Template Tags – Objects – Callbacks 2 Page 

Developing for Movable Type in 2 Days • Day 2: Building User Interfaces ➡ Introduc<on to Movable Type Applica<ons – Menus – New ApplicaBon Screens – Dialogs – LisBng Screens – Transformer Callbacks 3 Page 

IntroducBon to MT Apps • A collecBon of features that manifest in a coherent  interface. • Each has a dedicated .cgi • Why? – Portability – OpBmizaBon Page 

Example Apps • Atom ‐ Atom Publishing Protocol • CMS ‐ the Main MT ApplicaBon • XML‐RPC ‐ RESTian interfaces • Feeds ‐ AcBvity Feeds • Search ‐ Blog Side Searching • Comments ‐ Comment Processing • More.. Page 

Apps in the Registry name: Example Plugin for Movable Type id: Example key: Example description: This plugin is an example plugin for Movable Type. version: 1.0 applications: my_app: cgi_base: handler: methods: page_actions: list_actions: list_filters: search_apis: menus: widgets: blog_stats_tab: tags: import_formats: Page 

Developing for Movable Type in 2 Days • Day 2: Building User Interfaces – IntroducBon to Movable Type ApplicaBons ➡ Menus – New ApplicaBon Screens – Dialogs – LisBng Screens – Transformer Callbacks 7 Page 

Menus Page 

Adding Menus name: Example Plugin for Movable Type id: Example key: Example description: This plugin is an example plugin. version: 1.0 applications: cms: menus: create:video: label: 'Upload Video' mode: 'video_upload' order: 301 args: '_type': quot;blogquot; permission: 'manage_assets,publish_post' view: blog Page 

Menu ProperBes • label • mode • dialog • order • permission • args • view Page 

Developing for Movable Type in 2 Days • Day 2: Building User Interfaces – IntroducBon to Movable Type ApplicaBons – Menus ➡ New Applica<on Screens – Dialogs – LisBng Screens – Transformer Callbacks 11 Page 

CreaBng a New Screen in the App • Extending diﬀerent apps • Registering a “mode” • ImplemenBng a Handler • CreaBng a template • Working with Templates Page 

Registering a Mode name: Example Plugin for Movable Type id: Example key: Example description: This plugin is an example plugin. version: 1.0 applications: cms: methods: do_something: $Example::Example::Plugin::do_something Page 

Mode Handlers package Example::Plugin; use strict; sub plugin { return MT->component('Example'); } sub some_mode { my $app = shift; my $input = $app->{query}->param('some_form_parameter'); my $plugin = plugin(); my $tmpl = $plugin->load_tmpl('some_template.tmpl'); return $app->build_page( $tmpl );} } Page 

CreaBng a Template <mt:setvarblock name=quot;page_titlequot;>This is a page title</mt:setvarblock> <mt:include name=quot;include/header.tmplquot;> <p>Hello World!</p> <mt:include name=quot;include/footer.tmplquot;> Page 

Including Custom Javascript <mt:setvarblock name=quot;page_titlequot;>This is a page title</ mt:setvarblock> <mt:setvarblock name=quot;html_headquot; append=quot;1quot;> <script type=quot;text/javascriptquot;>  </script> </mt:setvarblock> <mt:include name=quot;include/header.tmplquot;> Page

Forms <mt:setvarblock name=quot;page_titlequot;>This is a page title</mt:setvarblock> <mt:include name=quot;include/header.tmplquot;> <form method=quot;postquot; enctype=quot;multipart/form-dataquot; action=quot;<mt:var name=quot;script_urlquot;>quot;> <input type=quot;hiddenquot; name=quot;__modequot; value=quot;a_modequot; /> <mt:if name=quot;blog_idquot;> <input type=quot;hiddenquot; name=quot;blog_idquot; value=quot;<mt:var name=quot;blog_idquot;>quot; /> </mt:if> <input type=quot;hiddenquot; name=quot;magic_tokenquot; value=quot;<mt:var name=quot;magic_tokenquot;>quot; /> <mtapp:setting id=quot;some_id_fieldquot; label=quot;Enter text herequot; hint=quot;Yay, text.quot; content_class=quot;field-content-textquot;> <input type=quot;textquot; name=quot;fooquot; size=quot;30quot; /> </mtapp:setting> <mt:setvarblock name=quot;action_buttonsquot;> <button type=quot;submitquot; accesskey=quot;squot; title=quot;Continue (s)quot; class=quot;primary-buttonquot;>Continue</button> </mt:setvarblock> <mt:include name=quot;include/actions_bar.tmplquot; bar_position=quot;bottomquot; hide_pager=quot;1quot; settings_bar=quot;1quot;> </form> <mt:include name=quot;include/footer.tmplquot;> Page 

Working with Variables <mt:setvarblock name=quot;page_titlequot;>This is a page title</mt:setvarblock> <mt:include name=quot;include/header.tmplquot;> <p>Hello <mt:var name=quot;personquot;>!</p> <mt:include name=quot;include/footer.tmplquot;> sub some_mode { my $app = shift; my $input = $app->{query}->param('some_form_parameter'); my $plugin = plugin(); my $param = {}; $param->{person} = quot;Byrne”; my $tmpl = $plugin->load_tmpl('some_template.tmpl'); return $app->build_page( $tmpl, $param ); } Page 

Developing for Movable Type in 2 Days • Day 2: Building User Interfaces – IntroducBon to Movable Type ApplicaBons – Menus – New ApplicaBon Screens ➡ Dialogs – LisBng Screens – Transformer Callbacks 19 Page 

Dialogs Page 

Dialog Template <mt:var name=quot;page_titlequot; value=quot;My Dialog Titlequot;> <mt:include name=quot;dialog/header.tmplquot;>  <mt:include name=quot;dialog/footer.tmplquot;> Page

Dialog Bu^ons <form ....>  <div class=quot;actions-barquot;> <div class=quot;actions-bar-inner pkg actionsquot;> <button type=quot;buttonquot; accesskey=quot;squot; class=quot;primary-button closequot;>Confirm</button> <button onclick=quot;closeDialog(); return falsequot; type=quot;submitquot; class=quot;cancelquot; accesskey=quot;xquot; title=quot;Cancel (x)quot;>Cancel</button> </div> </div> </form> Page

Developing for Movable Type in 2 Days • Day 2: Building User Interfaces – IntroducBon to Movable Type ApplicaBons – Menus – New ApplicaBon Screens – Dialogs ➡ Lis<ng Screens – Transformer Callbacks 23 Page 

LisBng Screens Page 

LisBng Template Stub <mt:setvar name=quot;page_titlequot; value=quot;My Listingquot;> <mt:setvarblock name=quot;html_headquot; append=quot;1quot;></mt:setvarblock> <mt:setvarblock name=quot;system_msgquot;></mt:setvarblock> <mt:setvarblock name=quot;related_contentquot;></mt:setvarblock> <mt:setvarblock name=quot;html_body_footerquot;> <mt:include name=quot;include/display_options.tmplquot;> </mt:setvarblock> <mt:setvarblock name=quot;action_buttonsquot;></mt:setvarblock> <mt:include name=quot;include/header.tmplquot;> <div class=quot;listing-filterquot;> <div class=quot;listing-filter-inner inner pkgquot;></div> </div> <mtapp:listing id=“my-table-id” type=quot;profileeventquot; default=quot;No events could be found.quot; empty_message=quot;No events could be found.quot;> </mtapp:listing> <mt:include name=quot;include/footer.tmplquot;> Page 

LisBng Template <mtapp:listing type=quot;mybojectquot; default=quot;No my objects could be found.quot; empty_message=quot;No my objects could be found.quot;> <mt:if name=quot;__first__quot;> <thead> <tr> <th class=quot;cbquot;><input type=quot;checkboxquot; id=quot;select-all-checkboxquot; name=quot;id-headquot; value=quot;allquot; class=quot;selectquot; /></th> <th>Column 1</th> <th>Column 2</th> <th>A Date</th> </tr> </thead> <tbody> </mt:if> <tr class=quot;<mt:if name=quot;__odd__quot;>odd<mt:else>even</mt:if>quot;> <td class=quot;cbquot;> <input type=quot;checkboxquot; name=quot;idquot; value=quot;<mt:var name=quot;idquot;>quot; class=quot;selectquot; /> </td> <td><mt:var name=quot;column1quot; remove_html=quot;1quot;></td> <td><mt:var name=quot;column2quot; remove_html=quot;1quot;></td> <td><mt:var name=quot;datequot; remove_html=quot;1quot;></td> </tr> </mtapp:listing> Page 

LisBng Handler sub list_profileevent { my $app = shift; my %param = @_; # Send the user to the dashboard if no blog ID has been provided. $app->return_to_dashboard( redirect => 1 ) if $app->param('blog_id'); my %service_styles; my @service_styles_loop; # This anonymous subroutine will process each row of data. It takes # as input the object associated with the current row, and an empty # hash for the row that should be populated with content from the # $obj passed to it. my $code = sub { my ($obj, $row) = @_; $row->{'column1'} = $obj->some_property; $row->{'column2'} = $obj->another_property; my $ts = $row->{created_on}; $row->{date} = relative_date($ts, time); }; # %terms is used in case you want to filter the contents of the # table in someway my %terms = ( author_id => $app->user->id, ); Page 

LisBng Handler # %args is used in case you want to sort or otherwise modify the # query arguments of the table my %args = ( sort => 'created_on', direction => 'descend', ); # %params is an addition hash of input parameters into the template # and can be used to hold an arbitrary set of name/value pairs that # can be displayed in your template. my %params = ( some_variable => 'You can do ANYTHING in Movable Type', ); # Fetch an instance of the current plugin using the plugin's key my $plugin = MT->component('Example'); # The main work horse of your handler. This will actually conduct # the query to the database for you, populate all that is necessary # for the pagination controls and more. The query is filtered and # controlled using the %terms and %args parameters. $app->listing({ type => 'myobject', # the ID of the object in the registry terms => %terms, args => %args, listing_screen => 1, code => $code, template => $plugin->load_tmpl('my_table.tmpl'), params => %params, }); } Page 

Developing for Movable Type in 2 Days • Day 2: Building User Interfaces – IntroducBon to Movable Type ApplicaBons – Menus – New ApplicaBon Screens – Dialogs – LisBng Screens ➡ Transformer Callbacks 29 Page 

Transformer Callbacks Page 

Callback Types • Transform the template’s source: – MT::App::CMS::template_source • Transform the template’s DOM: – MT::App::CMS::template_param • Transform the template’s output: – MT::App::CMS::template_output Page 

Registering the Callback name: Example Plugin for Movable Type id: Example key: Example description: This plugin is an example. version: 1.0 callbacks: MT::App::CMS::template_source.edit_entry: $Example::Example::Plugin::xfrm Page 

Regular Express Callback sub my_xfrm_callback { my ($cb, $app, $tmpl) = @_; my $slug = <<END_TMPL; A whole bunch of HTML here END_TMPL $$tmpl =~ s/(<li>Utilitiesn<ul class=quot;subquot;>)/$1$slug/; } Page 

Thank you! Byrne Reese byrne@sixapart.com Page 

http://movable-type.ru	25
http://www.composing-stick.net	18
http://blog.iup.edu	16
https://intranet.sixapart.com	8
http://www.slideshare.net	7
http://dev.blog.iup.edu	5
http://tonisalternateworld.blogspot.com	3
http://www.pairacy.com	2
http://thecomposingstick.com	2
http://ideasatrandom.wordpress.com	1

Hacking Movable Type Training - Day 2

by Byrne Reese on Oct 17, 2008

Accessibility

Categories

Tags

Upload Details

Usage Rights

10 Embeds 87

Statistics

Hacking Movable Type Training - Day 2 — Presentation Transcript