# iogLinksAdminPlugin

With this plugin you can manage your link's page in your website, in a hierarchal structure, with nested levels of categories. There are a frontend module to show the links and a backend module to manage. It uses jQuery library to show the hierarchal structure in backend module and is I18n prepared. 

## How to install ## 

1 - Install the plugin.

The easiest way to install is to use the symfony command line:

    > php symfony plugin:install iogLinksAdminPlugin

Alternatively, if you don't have PEAR installed, you can download the latest package attached to this plugin's wiki page and extract it under your project's `plugins/` directory. 
 
If you use one of these alternative methods, you must publish the plugin assets by calling the `plugin:publish-assets` symfony task.

2 - Build the data structures
 
Rebuild the model and generate the SQL code for the new tables:

    > php symfony propel:build-model
	> php symfony propel:build-forms
	> php symfony propel:build-filters
    > php symfony propel:build-sql

Be aware because in this alpha version, the name of the table to generate are Links (and not iogLinks as usual). 

3 - Configure your project to use the plugin features

Enable the 'iogLinksAdmin' module in your backend app (or whatever you want) and the 'iogLinks' module in your frontend via the `settings.yml`.


    // in myproject/apps/backend/config/settings.yml
    all:
      .settings:
        enabled_modules:        [default, iogLinksAdmin]

4 - Clear the cache to enable the autoloading to find the new classes:
    
    > php symfony cc

5 - Use the bundled `link:create-root` task to initialize the database. It's necessary to create the root element of the nested links collection. 

    > php symfony link:create-root
	

##Configuration


You must define the cultures used in your project into the app.yml file. With this information, the links admin form will create any fields as cultures. 

	//in myproject/apps/frontend/config/app.yml
	all:			
	  .group:
        idiomes_web: { Català: ca_ES: , Español: es_ES , English: en_US }


*It's document is a variation of sfAsset readme. 

##TODO

There are a lot of things to do! 

* Test all
* Create a baseIogLinks.class.php into lib directory in every module.
* Create a best view of the frontend module.
* Create the tests.
* Add some fixture data
* Add options to drag and reorder de links list. 
* Change the name of links class to iogLinks class.
* Make this todo list more extensive.