{"id":969,"date":"2011-12-05T20:40:01","date_gmt":"2011-12-06T03:40:01","guid":{"rendered":"http:\/\/www.analogrithems.com\/rant\/?p=969"},"modified":"2011-12-05T21:04:08","modified_gmt":"2011-12-06T04:04:08","slug":"revisionable-behavior-in-cakephp","status":"publish","type":"post","link":"https:\/\/www.analogrithems.com\/rant\/revisionable-behavior-in-cakephp\/","title":{"rendered":"Revisionable Behavior in CakePHP"},"content":{"rendered":"

There have been many times where I need to have some sort of revision ability in my cake apps. \u00c2\u00a0I’ve looked through the bakery and never found a very good clean solution. \u00c2\u00a0I thought about it for a bit and it seems like a pretty simple thing to do, so I made a light weight simple behavior that provides this<\/p>\n

The behavior is built into a plugin because it also has an simple model(table) that it uses to store revisions for all the other tables. \u00c2\u00a0The idea is that when ever you update your table this behavior will jump in, grab the current copy of the data and save it to the revisions table with the current timestamp. \u00c2\u00a0It then adds a few functions to your model you’ve added the behavior on to make sure it can see the previous behaviors.<\/p>\n

One of the best features of this plugin is that it will store multiple models revisions all in the same table.<\/p>\n

I’ve written this for CakePHP 1.3.x so it make not work with older or newer versions. Let me know if you have any questions or feedback<\/p>\n

You may now be asking your self, where can one find such a fine piece of code? \u00c2\u00a0As with most of my code it resides on github \u00c2\u00a0https:\/\/github.com\/analogrithems\/revisionable<\/a><\/p>\n

So far it is very simple, all you have to do add re-visioning to your models is add the revisionable behavior to your plugin.<\/p>\n

Setup<\/h3>\n

1) First you need to add the table to your project use the following to generate that
\n\tcake schema create Revisionable.revision<\/p>\n

2) add the behavior to your model like so <\/p>\n

[php]
\n\tvar $actAs = array(‘Revisionable.Revisionable’);
\n[\/php]<\/p>\n

Some Configure options<\/h3>\n

If you already have a table named revisions in your project and need to call the it something else then
\nmake a new table\/model in your project that has the same schema as this plugin and pass that model name
\nto the actAs setup like so<\/p>\n

[php]
\n\tvar $actAs(‘Revisionable.Revisionable’=>array(‘revisionableModel’=>$newModelName));
\n[\/php]<\/p>\n

To Do<\/h2>\n

So far aside from creating a revision everytime the data changes the only other feature of this plugin
\nis the listRevisions function. It works like this<\/p>\n

[php]
\n\t$revisions = $this->Model->listRevisions($this->Model->id);<\/p>\n

\tprint_r($revisions);
\n\tarray(
\n\t\t‘2011-12-05 01:01:01’=> array(
\n\t\t\t‘Pages’ => array(
\n\t\t\t\t‘id’=> ‘4edd8cc3-a628-490b-8cbf-6435ac1005e9’,
\n\t\t\t\t‘name’=> ‘foobar’,
\n\t\t\t\t‘body’=> ‘….’
\n\t\t\t)
\n\t\t)
\n\t);
\n[\/php]<\/p>\n

Need to create some more functions that add to this, like a a restore where you pass the id & date and
\nit will do a restore and perhaps a diff viewer. Patches are warmly welcome.<\/pre>\n

 
\nAlso I use uuid as my primaryKeys I will try to find some time to ad a configuration option that will allow for int as the primaryKey. In all reality, nothing really prevents this from working with int except for the table schema, so if you just change the table schema to use int then the rest of the plugin will follow.<\/p>\n","protected":false},"excerpt":{"rendered":"

There have been many times where I need to have some sort of revision ability in my cake apps. \u00c2\u00a0I’ve looked through the bakery and never found a very good clean solution. \u00c2\u00a0I thought about it for a bit and it seems like a pretty simple thing to do, so I made a light weight […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8,40],"tags":[],"class_list":["post-969","post","type-post","status-publish","format-standard","hentry","category-cakephp","category-web-development"],"_links":{"self":[{"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/posts\/969","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/comments?post=969"}],"version-history":[{"count":5,"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/posts\/969\/revisions"}],"predecessor-version":[{"id":971,"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/posts\/969\/revisions\/971"}],"wp:attachment":[{"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/media?parent=969"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/categories?post=969"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.analogrithems.com\/rant\/wp-json\/wp\/v2\/tags?post=969"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}