para 0.4.0

data/app/views/para/inputs/_nested_one.html.haml

@@ -0,0 +1,3 @@
+.nested-one-field
+  = form.simple_fields_for attribute_name, resource, nested_attribute_name: attribute_name do |nested_form|
+    = render partial: find_partial_for(model, :fields), locals: { form: nested_form, parent: form.object }

data/config/locales/en.yml

@@ -0,0 +1,86 @@
+en:
+  para:
+    flash:
+      shared:
+        create:
+          success: "%{model} created"
+          error: "Could not create %{model}"
+        update:
+          success: "%{model} updated"
+          error: "Could not update %{model}"
+        destroy:
+          success: "%{model} deleted"
+          error: "Could not delete %{model}"
+
+    admin:
+      title: "Admin"
+
+    confirmation:
+      shared:
+        destroy: 'Are you sure that you want to delete %{model} ?'
+
+    component:
+      create: "Create a component"
+      add: "Add a component"
+      none_created: "No components created for now ..."
+      crud:
+        name: "Resources list"
+      singleton_resource:
+        name: "Resource form"
+
+    component_section:
+      add: "Add a component section"
+      edit: 'Edit section'
+      destroy: 'Delete section'
+      actions: "Actions"
+
+    form:
+      shared:
+        new:
+          title: "Create new %{model}"
+      nested:
+        name: "Name"
+        add: "Add"
+        remove: "Remove"
+        new: "New"
+
+    list:
+      search_title: "Search"
+      delete_confirmation: "Are you sure that you want to delete this item ?"
+      no_results: "No results found, please try with other criterions"
+      empty: "The list is empty"
+
+    shared:
+      save: "Save"
+      cancel: "Cancel"
+      add: "Create"
+      search: "Search"
+      save_and_edit: "Save and edit"
+      save_and_add_another_button: "Save and create a other"
+
+    types:
+      boolean:
+        "true": "Yes"
+        "false": "No"
+
+  activerecord:
+    errors:
+      relation_length_is_smaller: "must contain at least %{minimum} elements"
+      relation_length_is_greater: "must contain at most %{minimum} elements"
+    models:
+      para/component/base:
+        one: "Component"
+        other: "Components"
+      para/component/crud:
+        one: "Resource listing"
+        other: "Resource listings"
+      para/component/singleton_resource:
+        one: "Resource form"
+        other: "Resource forms"
+    attributes:
+      para/component/base:
+        name: "Title"
+        type: "Type"
+        model_type: "Resource"
+        namespaced: "Only list component's resources"
+

data/config/locales/fr.yml

@@ -0,0 +1,101 @@
+fr:
+  para:
+    flash:
+      shared:
+        create:
+          success: "%{model} créé(e)"
+          error: "Impossible de créer le(a) %{model}"
+        update:
+          success: "%{model} mis(e) à jour avec succès."
+          error: "Impossible de mettre à jour le(a) %{model}"
+        destroy:
+          success: "%{model} supprimé(e)"
+          error: "Impossible de supprimer le(a) %{model}"
+        clone:
+          success: "%{model} cloné(e)"
+          error: "Impossible de cloner le(a) %{model}"
+
+    admin:
+      title: "Administration"
+      toggle_navigation: "Open navigation"
+      back_to_app: "Retour à l'application"
+      sign_out: "Se déconnecter"
+
+    confirmation:
+      shared:
+        destroy: 'Etes-vous sure de vouloir supprimer %{model} ?'
+
+    component:
+      create: "Créer un(e) Composant"
+      add: "Ajouter un composant"
+      none_created: "Aucune page pour le moment ..."
+      crud:
+        name: "Listing de ressources"
+      singleton_resource:
+        name: "Formulaire de ressource"
+
+    component_section:
+      add: "Ajouter une section"
+      edit: 'Modifier la section'
+      destroy: 'Supprimer la section'
+      actions: "Actions"
+
+    form:
+      shared:
+        new:
+          title: "Créer un(e) %{model}"
+      nested:
+        name: "Nom"
+        add: "Ajouter"
+        remove: "Supprimer"
+        new: "Nouveau"
+
+    list:
+      search_title: "Recherche"
+      delete_confirmation: "Êtes vous sûr de bien vouloir supprimer cette entrée ?"
+      no_results: "Aucun résultat pour cette recherche, merci d'essayer avec d'autres critères"
+      empty: "Aucune entrée créée pour le moment"
+
+    export:
+      name: "Export %{name}"
+      as: "Exporter (.%{extension})"
+
+    shared:
+      save: "Enregistrer"
+      cancel: "Annuler"
+      add: "Créer"
+      search: "Rechercher"
+      save_and_edit: "Enregistrer et éditer"
+      save_and_add_another_button: "Enregistrer et créer un(e) autre"
+
+    types:
+      boolean:
+        "true": "Oui"
+        "false": "Non"
+
+  activerecord:
+    errors:
+      relation_length_is_smaller: "doit contenir au moins %{minimum} éléments"
+      relation_length_is_greater: "doit contenir au maximum %{minimum} éléments"
+    models:
+      para/component/base:
+        one: "Composant"
+        other: "Composants"
+      para/component/crud:
+        one: "Listing de ressources"
+        other: "Listings de ressources"
+      para/component/singleton_resource:
+        one: "Formulaire de ressource"
+        other: "Formulaires de ressource"
+    attributes:
+      para/component/base:
+        name: "Titre"
+        type: "Type"
+        model_type: "Ressource"
+        namespaced: "Ne lister que les ressources du componsant ?"
+
+  activemodel:
+    models:
+      settings_rails/form:
+        one: "Configuration"
+        other: "Configuration"

data/db/migrate/20140911091225_create_para_components.rb

@@ -0,0 +1,19 @@
+class CreateParaComponents < ActiveRecord::Migration
+  def up
+    execute 'CREATE EXTENSION IF NOT EXISTS hstore'
+
+    create_table :para_components do |t|
+      t.string :type
+      t.string :name
+      t.hstore :configuration, default: '', null: false
+      t.integer :position, default: 0
+      t.integer :component_section_id
+
+      t.timestamps
+    end
+  end
+
+  def down
+    drop_table :para_components
+  end
+end

data/db/migrate/20140911112150_add_slug_to_para_components.rb

@@ -0,0 +1,6 @@
+class AddSlugToParaComponents < ActiveRecord::Migration
+  def change
+    add_column :para_components, :slug, :string
+    add_index :para_components, :slug
+  end
+end

data/db/migrate/20140929125733_create_para_component_sections.rb

@@ -0,0 +1,8 @@
+class CreateParaComponentSections < ActiveRecord::Migration
+  def change
+    create_table :para_component_sections do |t|
+      t.string :name
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20140929131111_add_identifier_to_para_component_sections.rb

@@ -0,0 +1,5 @@
+class AddIdentifierToParaComponentSections < ActiveRecord::Migration
+  def change
+    add_column :para_component_sections, :identifier, :string
+  end
+end

data/db/migrate/20140930121822_add_position_to_para_component_section.rb

@@ -0,0 +1,5 @@
+class AddPositionToParaComponentSection < ActiveRecord::Migration
+  def change
+    add_column :para_component_sections, :position, :integer
+  end
+end

data/db/migrate/20150129170710_create_para_component_resources.rb

@@ -0,0 +1,13 @@
+class CreateParaComponentResources < ActiveRecord::Migration
+  def change
+    create_table :para_component_resources do |t|
+      t.references :component, index: true
+      t.references :resource, index: true, polymorphic: true
+
+      t.timestamps null: false
+    end
+
+    add_foreign_key :para_component_resources, :para_components,
+                    column: :component_id
+  end
+end

data/db/migrate/20150203173219_add_identifier_to_para_components.rb

@@ -0,0 +1,5 @@
+class AddIdentifierToParaComponents < ActiveRecord::Migration
+  def change
+    add_column :para_components, :identifier, :string
+  end
+end

data/lib/generators/para/admin_user/admin_user_generator.rb

@@ -0,0 +1,16 @@
+module Para
+  class AdminUserGenerator < Rails::Generators::Base
+    source_root File.expand_path("../templates", __FILE__)
+
+    def create_admin_user
+      say 'Creating default admin...'
+
+      email =    ask('Email    [admin@example.com] : ').presence || 'admin@example.com'
+      password = ask('Password [password]          : ').presence || 'password'
+
+      AdminUser.create! email: email, password: password
+
+      say 'Created AdminUser'
+    end
+  end
+end

data/lib/generators/para/component/component_generator.rb

@@ -0,0 +1,59 @@
+module Para
+  class ComponentGenerator < Rails::Generators::NamedBase
+    source_root File.expand_path('../templates', __FILE__)
+
+    desc 'Para component generator'
+
+    def welcome
+      say 'Creating component...'
+    end
+
+    def copy_component
+      template 'component.rb', "app/components/#{ component_file_name }.rb"
+    end
+
+    def copy_component_controller
+      template 'component_controller.rb', "app/controllers/admin/#{ component_file_name }_controller.rb"
+    end
+
+    def add_require_to_application_controller
+      prepend_to_file 'app/controllers/application_controller.rb' do
+        "require '#{ component_file_name }'\n"
+      end
+    end
+
+    def create_show_component_view
+      template 'show.html.haml', "app/views/admin/#{ component_file_name }/show.html.haml"
+    end
+
+    def add_route
+      route_file = File.read(Rails.root.join('config/routes.rb'))
+
+      unless route_file.match /^\s+namespace :admin do/
+        route "namespace :admin do\n  end\n"
+      end
+
+      inject_into_file 'config/routes.rb', after: '  namespace :admin do' do
+        "\n    component :#{ file_name } do\n    end"
+      end
+    end
+
+    private
+
+    def component_name
+      if class_name.match(/Component/i)
+        class_name
+      else
+        "#{ class_name }Component"
+      end
+    end
+
+    def component_file_name
+      if file_name.match(/component/i)
+        file_name
+      else
+        "#{ file_name }_component"
+      end
+    end
+  end
+end

data/lib/generators/para/component/templates/component.rb

@@ -0,0 +1,3 @@
+class <%= component_name %> < Para::Component::Base
+  register :<%= file_name %>, self
+end

data/lib/generators/para/component/templates/component_controller.rb

@@ -0,0 +1,7 @@
+module Admin
+  class <%= class_name %>ComponentController < Para::Admin::ComponentController
+    def show
+      # You can access @component here
+    end
+  end
+end

data/lib/generators/para/component/templates/show.html.haml

@@ -0,0 +1,2 @@
+.page-title
+  %h1= @component.name

data/lib/generators/para/exporter/exporter_generator.rb

@@ -0,0 +1,42 @@
+module Para
+  class ExporterGenerator < Rails::Generators::NamedBase
+    source_root File.expand_path('../templates', __FILE__)
+
+    argument :formats, type: :array
+
+    desc 'Para exporter generator'
+
+    def copy_resource_exporter
+      formats.each do |format|
+        # Set the format to be accessible by the template to define its
+        # class name
+        @format = format
+
+        template(
+          "#{ base_exporter_template_name_for(format) }_exporter.rb",
+          "app/exporters/#{ format }/#{ plural_file_name }_exporter.rb"
+        )
+      end
+    end
+
+    private
+
+    def model_exporter_name
+      Para::Exporter.model_exporter_name(class_name)
+    end
+
+    def format_module_name_for(format)
+      Para::Exporter.format_exporter_name(format)
+    end
+
+    def base_exporter_template_name_for(format)
+      format_specific_template = "../templates/#{ format }_exporter.rb"
+
+      if File.exists?(File.expand_path(format_specific_template, __FILE__))
+        format
+      else
+        'base'
+      end
+    end
+  end
+end

data/lib/generators/para/exporter/templates/base_exporter.rb

@@ -0,0 +1,15 @@
+module <%= format_module_name_for(@format) %>
+  class <%= model_exporter_name %> < Para::Exporter::Base
+    def extension
+      '<%= @format %>'
+    end
+
+    def name
+      'export'
+    end
+
+    def render
+      # Add your export logic here
+    end
+  end
+end

data/lib/generators/para/exporter/templates/csv_exporter.rb

@@ -0,0 +1,13 @@
+module <%= format_module_name_for(@format) %>
+  class <%= model_exporter_name %> < Para::Exporter::Csv
+    def name
+      'export'
+    end
+
+    private
+
+    def fields
+      [:id]
+    end
+  end
+end

data/lib/generators/para/form/form_generator.rb

@@ -0,0 +1,15 @@
+module Para
+  class FormGenerator < Para::Generators::NamedBase
+    include Para::Admin::BaseHelper
+    include Para::Generators::FieldHelpers
+
+    source_root File.expand_path("../templates", __FILE__)
+
+    def generate_form
+      template(
+        "_form.html.haml",
+        "app/views/admin/#{ plural_namespaced_path }/_form.html.haml"
+      )
+    end
+  end
+end

data/lib/generators/para/form/templates/_form.html.haml

@@ -0,0 +1,7 @@
+= para_form_for(resource) do |form|
+  = form.fieldset do
+  <%- attributes.each do |field| -%>
+    = form.<%= field.field_method %> :<%= field.field_name %><%= field_options_for(field) %>
+  <%- end -%>
+
+  = form.actions

data/lib/generators/para/install/install_generator.rb

@@ -0,0 +1,112 @@
+module Para
+  class InstallGenerator < Rails::Generators::Base
+    source_root File.expand_path('../templates', __FILE__)
+
+    desc 'Para install generator'
+
+    def welcome
+      say 'Installing para engine ...'
+    end
+
+    def copy_initializer_file
+      copy_file 'initializer.rb', 'config/initializers/para.rb'
+    end
+
+    def copy_components_config
+      copy_file 'components.rb', 'config/components.rb'
+    end
+
+    def copy_migrations
+      rake 'para_engine:install:migrations'
+    end
+
+    def install_gems
+      gemfile_contents = File.read(Rails.root.join('Gemfile'))
+
+      [
+        ['devise', '~> 3.0'],
+        ['simple_form'],
+        ['simple_form_extension'],
+        # Pull requests are pending, and I don't want to release the gem
+        # under another name to be able to depend on it
+        ['active_decorator', github: 'glyph-fr/active_decorator', branch: 'dev'],
+        ['paperclip', '~> 4.2'],
+        ['cancancan', '~> 1.9'],
+        ['friendly_id', '~> 5.0'],
+        ['rolify', '~> 3.4'],
+        ['kaminari', '>= 0.16.1'],
+        ['ransack', '>= 1.4.1'],
+        ['bootstrap-kaminari-views', '>= 0.0.5']
+      ].each do |name, *args|
+        unless gemfile_contents.match(/gem ['"]#{ name }['"]/)
+          gem name, *args
+        end
+      end
+    end
+
+    def bundle_install
+      Bundler.with_clean_env do
+        run 'bundle install'
+      end
+    end
+
+    def friendly_id_install
+      generate 'friendly_id'
+    end
+
+    def simple_form_install
+      generate 'simple_form:install', '--bootstrap'
+      generate 'simple_form_extension:install'
+    end
+
+    def cancan_install
+      generate 'cancan:ability'
+    end
+
+    def devise_install
+      generate 'devise:install'
+      generate 'devise', 'AdminUser'
+    end
+
+    def rolify_install
+      generate 'rolify Role AdminUser'
+    end
+
+    def migrate
+      rake 'db:migrate'
+    end
+
+    def add_admin_user_to_ability
+      inject_into_file 'app/models/ability.rb', after: '# Define abilities for the passed in user here. For example:' do
+        "\n\n    if user.is_a?(AdminUser)\n      can :manage, :all\n    end\n"
+      end
+    end
+
+    def create_default_admin
+      generate 'para:admin_user'
+    end
+
+    def mount_engine
+      say "Mounting Para engine in routes"
+      gsub_file 'config/routes.rb', /para_at.+\n/, ''
+      route "para_at '/'"
+    end
+
+    def final_message
+      say <<-MESSAGE
+
+*******************************************************************************
+
+Para was successfully installed in your app.
+
+Please not that your should define your root path in your application routes.rb
+for the Para admin panel to work :
+
+  e.g.: root to: 'home#index'
+
+*******************************************************************************
+
+      MESSAGE
+    end
+  end
+end

data/lib/generators/para/install/templates/components.rb

@@ -0,0 +1,13 @@
+Para.components.draw do
+  # Create a components section in the menu with a :menu identifier
+  # You can translate the section title at: components.section.menu
+  #
+  # section :menu do
+  #
+  #  # Create a component of type :crud in the the section :menu, with the
+  #  # identifier :pages, with the model 'Page' as the target type and
+  #  # namespacing it's managed to resources to the component
+  #  #
+  #  component :pages, :crud, model_type: 'Page', namespaced: true
+  # end
+end

data/lib/generators/para/install/templates/initializer.rb

@@ -0,0 +1,23 @@
+Para.config do |config|
+  # Configure authentication method to be called when accessing the admin panel
+  # config.authenticate_admin_method = :authenticate_admin!
+
+  # Configure the method to retrieve current admin user from
+  # config.current_admin_method = :current_admin_user
+
+  # Configure the default Kaminari pagination theme to use
+  # config.pagination_theme = 'twitter-bootstrap-3'
+
+  # Configure the default admin HTML page <title>
+  # config.admin_title = I18n.t('para.admin.title')
+
+  # Configure the default max depth for trees
+  # config.default_tree_max_depth = 3
+
+  # Configure the methods which Para will try to call on resources to fetch
+  # their name.
+  #
+  # Default is [:name, :title]
+  #
+  # config.resource_name_methods += [:full_name]
+end

data/lib/generators/para/nested_fields/nested_fields_generator.rb

@@ -0,0 +1,15 @@
+module Para
+  class NestedFieldsGenerator < Para::Generators::NamedBase
+    include Para::Admin::BaseHelper
+    include Para::Generators::FieldHelpers
+
+    source_root File.expand_path("../templates", __FILE__)
+
+    def generate_fields
+      template(
+        "_nested_fields.html.haml",
+        "app/views/admin/#{ plural_namespaced_path }/_fields.html.haml"
+      )
+    end
+  end
+end

data/lib/generators/para/nested_fields/templates/_nested_fields.html.haml

@@ -0,0 +1,3 @@
+<%- attributes.each do |field| -%>
+= form.<%= field.field_method %> :<%= field.field_name %><%= field_options_for(field) %>
+<%- end -%>