=== Plugin Name ===
Author: Francis Crossen (fcrossen)
Contributors: Francis Crossen (fcrossen)
License: GPLv2 or later
Donate link: http://seeit.org/tina-mvc-for-wordpress
Tags: plugin, widget, mvc, shortcode, development, framework, helper
Requires at least: 3.5
Tested up to: 3.5
Dev version: 1.0
Stable tag: 1.0

Tina MVC is a Wordpress framework that allows you to develop plugins, shortcodes and and widgets.

== Description ==

Tina MVC provides you with base classes and helper classes and functions on which you build your Wordpress applications.

It uses a lose model view controller pattern to abstract design and logic and make life easier for you and your HTML designer.

### Features:
* Completely separate your code from Wordpress themes. Your users can change their theme and still retain your application functionality.
* A helper class for generating and processing HTML forms.
* A helper class for generating paginated tables from SQL (for when custom posts are not appropriate).
* A helper class for generating HTML tables from your data.
* Separation of your code from core Tina MVC files for easy upgrades.
* Compact and non-intrusive. Currently 3 filters plus 1 action hook for widgets and 1 shortcode hook are used for basic usage.
* A function to allow you to call a Tina MVC controller from your theme file (breaks the MC) or from another controller.
* Flexible enough for quick procedural prototyping - don't like MVC? No problem!

### Tutorials, Documentation and Code Samples
All Tina MVC documentation is included with the plugin. After activating the plugin you can access it from the Wordpress admin back end. (Look for the Tina MVC administration page.)
Source code is liberally commented for PhpDocumentor.

### License
This version is GPL v2 licensed. If you are interested in alternative licensing models, or in commercial support, please contact the author at http://www.seeit.org/about-us/.

### Support
Support for this version is available at http://wordpress.org/tags/tina-mvc?forum_id=10 or by leaving a comment at http://www.seeit.org/tina-mvc-for-wordpress/.

== Installation ==

1. Install the usual way (if you can't manage that then this plugin isn't for you)
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go to the `Tina MVC` menu in the Wordpress administration back end for documentation
1. Navigate to the newly created `Tina MVC for Wordpress` page on your Wordpress site

== Upgrade Notice ==

The automatic upgrade feature will not work if your web server cannot write to the <code>wp-content</code> folder. * Always backup your apps. * 
You can upgrade manually:

1) Download and unzip; 2) Deactivate the plugin through the 'Plugins' menu in WordPress; 3) Backup the `user_apps` folder and `tina_mvc_app_settings.php`
and any other files and folders you created; 4) Delete the contents of the `tina-mvc` folder and copy back your backed up files; 5) Compare the new `app_settings_sample.php` file with your `app_settings.php` file and merge any changes; 
6) Reactivate the plugin

== Frequently Asked Questions ==

= What is Tina MVC used for? =

It is used for all my Wordpress development at this stage. Wordpress became my development platform of choice in early 2010 and Tina MVC allows me to develop client sites as Wordpress plugins.

= Does Tina MVC work with Wordpress Multisite? =

Yes. You can have all sites use the same application files, or have different application files for each blog within your network.

= My changes to <code>tina_mvc_app_settings.php</code> are being ignored... =

The <code>app_settings.php</code> file is only checked on plugin activation. Deactivate/reactivate the plugin to load the new settings.

= Can Tina MVC create posts on activation like it does pages? =

Yes. Put your code into <code>install_remove/tina_mvc_app_install.php</code>. Tina MVC will include it on activation and call the function <code>tina_mvc_app_install()</code>.

= Can my current controller use a view from inside another controllers folder? =

Yes. Just specify the view file name you want to use when you use the $this->load_view() function. You can also specify a custom location for your view file:
<code>$this->load_view( 'my_view_file' , FALSE , 'path/to/view/file/from/tina-mvc/folder' )</code>

= Why are there HTML template files in the plugin folder? =

Tina MVC applications are designed to be completely independent of the theme you use. The templates only format the post/page/shortcode/widget content.
You should be able to use any theme you want with a deployed Tina MVC application. This allows you to crack on with development while your designer (if there is one) deals with the theme.
Of course there is nothing to stop you putting code and calls to tina_mvc_call_page_controller() in your templates if you prefer, but it is not recommended.

= I'd love to see `insert feature here` in Tina MVC. How can I request this? =

See `Where can I get support?` below and just ask.

= Where can I get support? =

The 'Plugins and Hacks' forum (http://wordpress.org/tags/tina-mvc?forum_id=10) or at http://www.seeit.org/tina-mvc-for-wordpress/.

== Changelog ==

= 0.9 =
 * first beta release for Tina MVC 1.0 based on 0.4.15