iogLinksAdminPlugin - 0.0.3

symfony links plugin

You are currently browsing
the website for symfony 1

Visit the Symfony2 website


« Back to the Plugins Home

Signin


Forgot your password?
Create an account

Tools

Stats

advanced search
Information Readme Releases Changelog Contribute
Show source

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.