Extension

Les extensions permettent d'étendre les fonctionnalités ou de personnaliser Ekylibre. Le système d'extension fournit donc une liste de point d'entrée dans le logiciel.

Un des objectifs est de pouvoir installer une extension seulement en la plaçant dans le dossier plugins/ à la racine d'Ekylibre. Les routes, menus, droits, assets, contrôleurs/vues etc. doivent se mettre en place automatiquement sans configuration dans Ekylibre.

Plugfile
Gemfile
Rakefile
README.rdoc
app/
  assets/
    fonts/
    images/
    javascripts/
    stylesheets/
  controllers/
  themes/
  views/
config/
  rights.yml
  navigation.xml
  routes.rb
  locales/
lib/
  <extension>.rb
  <extension>/
    version.rb (?)
test/

Ce fichier permet de définir comment brancher l'extension dans Ekylibre. À la manière d'une gem, il permet aussi de poser les contraintes d'intégration.

add_theme_stylesheet 'tekyla', 'things'
add_theme_stylesheet '*', 'things'
add_theme_stylesheet /^tekyla-*/, 'things'

Définit la dépendance vis-à-vis d'Ekylibre.

app '1.1.3'
app '~> 1.1.3'
app '> 1.0.0'
app '>= 1.1.0', '< 2.0'

author 'Brice Texier <brice@ekylibre.com>'

Cet appel est nécessaire.

name 'super-fonctionnalite'

Cette directive permet d'appeler le script depuis application.js.

require_javascript 'foo/bar/baz'

Dans l'exemple ci-dessus, le fichier se trouve dans <plugin_root>/app/assets/javascripts/foo/bar/baz.js.coffee.

version '0.0.0'