@@ -167,17 +167,25 @@ src/Models/
167167A Hook is a PHP class that responds to an external event. Hooks are polled and executed by their corresponding scheduled Task.
168168
169169``` sql
170- INSERT INTO ` zz_hooks` (` name` , ` class` , ` enabled` , ` id_module` )
171- VALUES (' Mio Hook' , ' Modules\\ MioModulo\\ MioHook' , 1 , NULL );
170+ INSERT INTO ` zz_hooks` (` name` , ` class` , ` enabled` , ` id_module` ) VALUES
171+ (' Mio Hook' , ' Modules\\ MioModulo\\ MioHook' , 1 , NULL );
172+
173+ INSERT INTO ` zz_hooks_lang` (` id_lang` , ` id_record` , ` title` ) VALUES
174+ (1 , LAST_INSERT_ID(), ' Mio Hook' ),
175+ (2 , LAST_INSERT_ID(), ' My Hook' );
172176```
173177
174178### Scheduled Tasks / Cron (` zz_tasks ` )
175179
176180A Task is a PHP class executed by ` cron.php ` according to a cron expression.
177181
178182``` sql
179- INSERT INTO ` zz_tasks` (` name` , ` class` , ` expression` , ` enabled` )
180- VALUES (' Mio Task' , ' Modules\\ MioModulo\\ MioTask' , ' 0 */6 * * *' , 1 );
183+ INSERT INTO ` zz_tasks` (` name` , ` class` , ` expression` , ` enabled` ) VALUES
184+ (' Mio Task' , ' Modules\\ MioModulo\\ MioTask' , ' 0 */6 * * *' , 1 );
185+
186+ INSERT INTO ` zz_tasks_lang` (` id_lang` , ` id_record` , ` title` ) VALUES
187+ (1 , LAST_INSERT_ID(), ' Mio Task' ),
188+ (2 , LAST_INSERT_ID(), ' My Task' );
181189```
182190
183191---
@@ -227,62 +235,63 @@ switch (post('op')) {
227235### Registering a Module (` zz_modules ` )
228236
229237``` sql
230- INSERT INTO ` zz_modules`
231- (` name` , ` directory` , ` attachments_directory` , ` options` , ` icon` ,
232- ` version` , ` compatibility` , ` order` , ` parent` , ` default` , ` enabled` )
233- VALUES (
234- ' MioModulo' ,
235- ' mio_modulo' ,
236- ' mio_modulo' ,
237- ' SELECT |select| FROM `mia_tabella` WHERE 1=1 HAVING 2=2' ,
238- ' fa fa-cogs' ,
239- ' 2.12' ,
240- ' 2.*' ,
241- 1 ,
242- (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' Tabelle' ),
243- 1 ,
244- 1
245- );
246-
247- INSERT INTO ` zz_modules_lang` (` id_lang` , ` id_record` , ` title` , ` meta_title` )
248- VALUES (1 , LAST_INSERT_ID(), ' Mio Modulo' , ' Mio Modulo - {campo}' );
238+ INSERT INTO ` zz_modules` (` name` , ` directory` , ` attachments_directory` , ` options` , ` icon` , ` version` , ` compatibility` , ` order` , ` parent` , ` default` , ` enabled` ) VALUES
239+ (' MioModulo' , ' mio_modulo' , ' mio_modulo' , ' SELECT |select| FROM `mia_tabella` WHERE 1=1 HAVING 2=2' , ' fa fa-cogs' , ' 2.12' , ' 2.*' , 1 , null , 1 , 1 );
240+
241+ INSERT INTO ` zz_modules_lang` (` id_lang` , ` id_record` , ` title` , ` meta_title` ) VALUES
242+ (1 , LAST_INSERT_ID(), ' Mio Modulo' , ' Mio Modulo - {campo}' ),
243+ (2 , LAST_INSERT_ID(), ' My Module' , ' My Module - {field}' );
244+
249245```
250246
251247### Registering List Columns (` zz_views ` )
252248
253249``` sql
254250INSERT INTO ` zz_views` (` id_module` , ` name` , ` query` , ` order` , ` search` , ` slow` , ` default` , ` visible` ) VALUES
255- ((SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' id' , ' mia_tabella.id' , 1 , 0 , 0 , 1 , 0 ),
256- ((SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' Nome' , ' mia_tabella.nome' , 2 , 1 , 0 , 1 , 1 ),
257- ((SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' Data' , ' mia_tabella.data' , 3 , 1 , 0 , 1 , 1 );
251+ ((SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' id' , ' mia_tabella.id' , 1 , 0 , 0 , 1 , 0 ),
252+ ((SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' Nome' , ' mia_tabella.nome' , 2 , 1 , 0 , 1 , 1 ),
253+ ((SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' Data' , ' mia_tabella.data' , 3 , 1 , 0 , 1 , 1 );
254+
255+ INSERT INTO ` zz_views_lang` (` id_lang` , ` id_record` , ` title` ) VALUES
256+ (1 , (SELECT ` id` FROM ` zz_views` WHERE ` id_module` = (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ) AND ` name` = ' id' ), ' #' ),
257+ (2 , (SELECT ` id` FROM ` zz_views` WHERE ` id_module` = (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ) AND ` name` = ' id' ), ' #' ),
258+ (1 , (SELECT ` id` FROM ` zz_views` WHERE ` id_module` = (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ) AND ` name` = ' Nome' ), ' Nome' ),
259+ (2 , (SELECT ` id` FROM ` zz_views` WHERE ` id_module` = (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ) AND ` name` = ' Nome' ), ' Name' ),
260+ (1 , (SELECT ` id` FROM ` zz_views` WHERE ` id_module` = (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ) AND ` name` = ' Data' ), ' Data' ),
261+ (2 , (SELECT ` id` FROM ` zz_views` WHERE ` id_module` = (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ) AND ` name` = ' Data' ), ' Date' );
258262```
259263
260264### Registering a Plugin (` zz_plugins ` )
261265
262266``` sql
263- INSERT INTO ` zz_plugins`
264- (` name` , ` idmodule_from` , ` idmodule_to` , ` position` , ` enabled` , ` directory` )
265- VALUES (
266- ' MioPlugin' ,
267- (SELECT id FROM zz_modules WHERE name = ' ModuloHost' ),
268- (SELECT id FROM zz_modules WHERE name = ' ModuloTarget' ),
269- ' tab' ,
270- 1 ,
271- ' mio_plugin'
272- );
267+ INSERT INTO ` zz_plugins` (` name` , ` idmodule_from` , ` idmodule_to` , ` position` , ` enabled` , ` directory` ) VALUES
268+ (' MioPlugin' , (SELECT id FROM zz_modules WHERE name = ' MioModulo' ), (SELECT id FROM zz_modules WHERE name = ' MioModulo' ), ' tab' , 1 , ' mio_plugin' );
273269
274- INSERT INTO ` zz_plugins_lang` (` id_lang` , ` id_record` , ` title` )
275- VALUES (1 , LAST_INSERT_ID(), ' Mio Plugin' );
270+ INSERT INTO ` zz_plugins_lang` (` id_lang` , ` id_record` , ` title` ) VALUES
271+ (1 , LAST_INSERT_ID(), ' Mio Plugin' ),
272+ (2 , LAST_INSERT_ID(), ' My Plugin' );
276273```
277274
278275### Registering Settings (` zz_settings ` )
279276
280277``` sql
281- INSERT INTO ` zz_settings` (` id` , ` nome` , ` valore` , ` tipo` , ` editable` , ` sezione` , ` order` , ` is_user_setting` ) VALUES
282- (NULL , ' Abilita funzionalità X' , ' 0' , ' boolean' , 1 , ' Generali' , 10 , 0 );
278+ INSERT INTO ` zz_settings` (` nome` , ` valore` , ` tipo` , ` editable` , ` sezione` , ` order` , ` is_user_setting` ) VALUES
279+ (' Abilita funzionalità X' , ' 0' , ' boolean' , 1 , ' Generali' , 10 , 0 );
280+
281+ INSERT INTO ` zz_settings_lang` (` id_lang` , ` id_record` , ` title` , ` help` ) VALUES
282+ (1 , LAST_INSERT_ID(), ' Abilita funzionalità X' , ' Testo di aiuto' ),
283+ (2 , LAST_INSERT_ID(), ' Enable Feature X' , ' Help text' );
284+ ```
285+
286+ ### Registering Widgets (` zz_widgets ` )
287+
288+ ``` sql
289+ INSERT INTO ` zz_widgets` (` name` , ` type` , ` id_module` , ` location` , ` class` , ` query` , ` bgcolor` , ` icon` , ` print_link` , ` more_link` , ` more_link_type` , ` php_include` , ` enabled` , ` order` , ` help` ) VALUES
290+ (' Mio Widget' , ' stats' , (SELECT ` id` FROM ` zz_modules` WHERE ` name` = ' MioModulo' ), ' controller_top' , ' col-md-6' , ' SELECT COUNT(*) AS dato FROM mia_tabella WHERE 1=1' , ' #4ccc4c' , ' fa fa-check' , ' ' , ' ' , ' javascript' , ' ' , 1 , 1 , NULL );
283291
284- INSERT INTO ` zz_settings_lang` (` id_lang` , ` id_record` , ` title` , ` help` )
285- VALUES (1 , LAST_INSERT_ID(), ' Enable Feature X' , ' Help text' );
292+ INSERT INTO ` zz_widgets_lang` (` id_lang` , ` id_record` , ` title` , ` text` ) VALUES
293+ (1 , LAST_INSERT_ID(), ' Mio Widget' , ' Statistiche' ),
294+ (2 , LAST_INSERT_ID(), ' My Widget' , ' Statistics' );
286295```
287296
288297---
@@ -423,7 +432,7 @@ flash()->warning(tr('Warning: document already sent.'));
423432### Path Helpers
424433
425434``` php
426- base_path () // Root-relative URL for links
435+ base_path_osm () // Root-relative URL for links
427436base_dir() // Absolute filesystem path
428437redirect_url($url) // HTTP redirect
429438```
@@ -570,7 +579,7 @@ flash()->success(tr('...'))
570579flash()->error(tr('...'))
571580
572581// Path helpers
573- base_path ()
582+ base_path_osm ()
574583base_dir()
575584redirect_url($url)
576585
0 commit comments