Diferencias

Muestra las diferencias entre dos versiones de la página.

--- informatica:software:aplicaciones_web:saltcorn [2025/04/14 12:15] – tempwin
+++ informatica:software:aplicaciones_web:saltcorn [2025/04/15 12:10] (actual) – tempwin
@@ Línea 5: / Línea 5: @@
   * [[https://saltcorn.com/|Sitio web]]
   * [[https://github.com/saltcorn/saltcorn|Repositorio de código]]
+  * [[https://wiki.saltcorn.com/|Wiki]]
   * [[https://saltcorn.com/tenant/create|Demo]]
@@ Línea 140: / Línea 141: @@
 A partir de entonces, cuando cualquier visitante (cualquier persona no registrada) llegue a nuestra instalación de Saltcorn, verá la página que creamos.
+===== Tablas =====
+Útiles para generar contenido dinámico. En Saltcorn, una aplicación está asociada con una base de datos. Una base de datos es una colección de tablas. Las tablas se usan para estructurar los datos en filas y columnas / campos.
+Para crear tablas: //Tablas// -> **Create table**.
+Saltborn creará por nosotros el campo **ID** en cada tabla. Este campo se usará como **clave primaria**.
+Cuando creamos un campo nuevo, en //Label// podemos usar mayúsculas y espacios. Internamente, Saltburn sustituirá los espacios por guiones bajos (''_'') y pasará todo a minúsculas.
+Tipo de dato para los campos:
+  * **String**: sucesión de caracteres (texto).
+  * **Integer**: números enteros, positivos o negativos.
+  * **Bool**: valores //booleanos//, ''true'' (cierto) o ''false'' (falso).
+  * **Date**: fecha (con información de tiempo o no)
+  * **Float**: números decimales.
+  * **Color**: colores en formato RGB (Red Green Blue)
+  * **File**: referencia a un fichero del sistema de ficheros de Saltcorn.
+  * **Key to <TABLA>**: referencia a la clave foránea de cierta tabla. Se utiliza para enlazar datos de diferentes tablas y crear la estructura relacional de nuestra aplicación.
+Después de crear las tablas, lo normal es crear vistas para mostrar los datos de las tablas.
+===== Vistas =====
+Después de crear las tablas, lo normal es crear vistas para mostrar los datos de las tablas. No nos interesa que los usuarios vean los datos de la tabla tal cual están guardados en la base de datos. Tampoco solemos querer que el usuario pueda editar las tablas directamente. Para todo esto son útiles las vistas.
+Un vista pertenece a una tabla.
+Cada vista sigue un patrón de vista:
+  * **List**: shows a tabular grid of multiple rows in a table. You can define its columns which can be data from this or related tables, action buttons or links to other views.
+  * **Edit**: a form that can be used to create a new row or edit an existing row in a table.
+  * **Show**: a single existing row in the table. The row must be specified either by linking or embedding from another view or page.
+  * **Filter**: not display any data from the table but can be used to set up user interface elements that determine which rows are shown in other views on the same page.
+  * **Feed**: configured by another view which shows a single row and will repeat this view for all available rows.
+  * **ListShowList**: Combine an optional list view on the left with displays on the right of a single selected row, with views of related rows from different tables underneath
+  * **Room**: Real-time space for chat
+  * **Date Range Filter**: Limit selected rows to those for which a date fields falls in a range selected by the user.
+**List**, **Edit** y **Show** son los patrones más habituales.
+  * [[https://www.youtube.com/watch?v=M43dFzj2p9o|Getting started with Saltcorn views - List, Edit and Show [Aug 2022, v0.7.3]]] (YouTube)
 ===== Plugins / módulos =====
 Para extender las funcionalidades base de Saltcorn podemos instalar //plugins//. Por ejemplo, para que en los campos tipo fecha se muestre un calendario para elegir el día, podemos instalar **flatpickr-date**.
+Los plugins se instalan desde //Settings// -> //Modules// -> **Modules**.
+===== Packs =====
+Los //packs// ofrecen funcionalidades que podríamos conseguir mediante la creación de tablas, vistas, páginas... Nos permite construir por ejemplo un blog, una wiki, etc. Serían como aplicaciones completas. Proporcionan la estructura, no los datos.
+Los //packs// se instalan desde //Settings// -> //Modules// -> **Packs**.
+===== Usuarios =====
+//Settings// -> **Users and security**
+==== Crear usuario ====
+Como administrador, desde //Settings// -> //Users and security// -> **Users** podremos crear nuevos usuarios mediante el enlace **Create user**.
+===== Deshabilitar registros =====
+Si no queremos que cualquier visitante pueda crear una cuenta en nuestra instalación de Saltcorn, como administradores, debemos ir a //Settings// -> //Users and security// -> **Login and Signup**. Ahí desmarcaremos la casilla que pone //Allow users to sign up for a new user account//.
+Desde ese momento, la única manera de crear nuevas cuentas será desde el panel de administración, mediante //Settings// -> //Users and security// -> **Users**.
+===== Páginas =====
+==== Añadir página al menú de navegación ====
+Hay dos formas, una es ir al editor de menús (//Settings// -> //Site structure// -> **Menu**) y la otra es ir a //Pages//, localizar la página deseada y pulsar en el botón con los 3 puntos para luego elegir //Add to menu//.