bgcc/sf-bootstrap-propel-admin-theme-plugin

A bootstrap based admin generator theme for symfony 1 with propel 1.6+

sfBootstrapPropelAdminThemePlugin

, _(*1)

Description

The sfBootstrapPropelAdminThemePlugin is a symfony 1.4 plugin that provides a Bootstrap 3 based admin theme for Propel 1.5+. All icons are replaced with Font Awesome., _(*2)

Screenshots

Available Screenshots: * Login * Navigation * List * Responsive List * Form with tabs (first tab selected) * Form with tabs (second tab selected) * Form with tabs and error (second tab selected) * Responsive Form, _(*3)

View the gallery under http://imgur.com/a/Smu3G., _(*4)

Features

• Full features from admin15 theme of sfPropelORMPlugin
• Additional features
  • Session based batch selection of list items (keeps the selection upon navigation)
  • Override default settings via settings.yml
  • Changing the page title depending on module and action
  • Pagination inside the form
  • Enhanced generator.yml with tabs and panels
• Responsive layout
• Bootstrap 3
• Font Awesome
• Bootstrap 3 optimized widgets
• Auto-adding of necessary CSS classes to filter and form widgets

Requirements

• symfony 1.4
• sfPropelORMPlugin

Installation via Composer

{
    "require": {
        "bgcc/sf-bootstrap-propel-admin-theme-plugin": "dev-master"
    }
}

Installation via Git

• Install the plugin and init submodule, _(*5)

  $ git submodule add git://github.com/bgcc/sfBootstrapPropelAdminThemePlugin.git plugins/sfBootstrapPropelAdminThemePlugin
  $ git submodule update --init --recursive

Setup

• Enable the plugin in your /config/ProjectConfiguration.class.php php $this->enablePlugins('sfBootstrapPropelAdminThemePlugin');, _(*6)

• Publish assets, _(*7)

  $ ./symfony plugin:publish-assets

• Clear you cache, _(*8)

  $ ./symfony cc

• See the config folder of the plugin for examples of view.yml (for the application) and generator.yml., _(*9)

• Enable the module in your application_name/config/settings.yml yaml all: .settings: enabled_modules: [ theme ], _(*10)

• Generate a propel admin module with the bootstrap theme, _(*11)

  $ ./symfony propel:generate-admin --theme="bootstrap" application_name ModelName

Included Widgets

• sfWidgetFormBootstrap3I18nNumber: Input widget with an optional input-group that formats the number based on a given culture. php $this->setWidget('widget_name', new sfWidgetFormBootstrap3I18nNumber(array('culture' => 'de', 'prepend' => '€')));, _(*12)

• sfWidgetFormBootstrap3Input: Input widget with an optional input-group that formats the number based on a given culture. php $this->setWidget('widget_name', new sfWidgetFormBootstrap3Input(array('append' => '€')));, _(*13)

• sfWidgetFormBootstrap3SelectCheckbox: Renderer class for expandend multiple choice widgets. php $this->setWidget('widget_name', new sfWidgetFormChoice(array( 'choices' => $choices, 'expanded' => true, 'multiple' => true, 'renderer_class' => 'sfWidgetFormBootstrap3SelectCheckbox' )));, _(*14)

• sfWidgetFormBootstrap3SelectRadio: Renderer class for expandend choice widgets. php $this->setWidget('widget_name', new sfWidgetFormChoice(array( 'choices' => $choices, 'expanded' => true, 'renderer_class' => 'sfWidgetFormBootstrap3SelectRadio' )));, _(*15)

Bonus

• Check the signinSuccess.php in plugins/sfBootstrapPropelAdminThemePlugin/modules/theme/templates for a nice login page. Copy the content to the template of your signin action and modify it if it's necessary., _(*16)

• Modify the view.yml of the module where you sigin action is placed and add yaml signinSuccess: layout: %sf_plugins_dir%/sfBootstrapPropelAdminThemePlugin/templates/login, _(*17)

Contribution

• Issues and pull requests are welcome.
• If you have a feature request or question feel free to open an issue.