Home

Matilda Core è il modulo principale per la creazione di pannelli di amministrazione in Ruby on Rails.

Installazione

Il processo di installazione di Matilda Core rispetta l'installazione standard di un Rails Engine. Le sole variazioni riguardano la gestione dei moduli front-end al fine di permettere la personalizzazione e gestione degli assets tramite Webpacker.

1. Aggiungere la gemma al Gemfile

# /Gemfile
gem 'matilda_core', git: 'https://github.com/ideonetwork/matilda-core'

2. Installare ed eseguire le migrazioni

rails matilda_core:install:migrations
rails db:migrate

3. Copiare le dipendenze font-end nel proprio progetto

rails matilda_core:install:front

Il comando eseguito crea una copia di tutti i sorgenti javascript e scss in /vendor/matilda_core.

4. Installare le dipendenze front-end modificando il file /package.json

{
  "name": "app_name",
  "private": true,
  "dependencies": {
    "@matilda/core": "file:./vendor/matilda_core",
    // ...
  },
  "version": "0.1.0",
  "devDependencies": {
    // ...
  }
}

5. Creare un file di configurazione in /config/initializers/matilda_core.rb e inserire il seguente codice

MatildaCore.configure do |config|
  # Qui si possono sovrascrivere le configurazioni
end

6. Aggiungere le rotte sul file /config/routes.rb

Rails.application.routes.draw do
  # ...
  mount MatildaCore::Engine => '/matilda/core'
end

7. Aggiungere un file /app/javascript/packs/matilda.js per eseguire il require dei moduli di Matilda

import '../../../vendor/matilda_core/loader.js'

8. Aggiungere sul file di configurazione di webpacker, nell'array resolved_paths la path del modulo di Matilda

default: &default
  #...
  resolved_paths: ['vendor/matilda_core']