Introducción para desarrolladores

Estructura de directorios de SaltOS

SaltOS usa la siguiente estructura de carpetas:

  • cache: para los ficheros temporales
  • css: para los ficheros de estilo
  • doc: para la documentación
  • files: para los ficheros adjuntos y de configuración
  • img: para las imágenes (iconos y demás elementos gráficos)
  • inbox: para los correos entrantes (en formato RFC822 y con extensión .eml)
  • install: para el wizard de instalación
  • js: para los códigos JavaScript
  • lib: para las librerías de terceros
  • outbox: para los correos salientes (en formato RFC822 y con extensión .eml)
  • php: para los códigos PHP
    • action: para los códigos PHP clasificados como actions
    • database: para los drivers PHP de acceso a bases de datos
  • xml: para los ficheros de configuración XML
    • common: para los ficheros XML comunes en otros ficheros XML
    • lang: para los ficheros XML que proporcionan los literales a cada idioma
  • xsl: para los ficheros de transformación de XSLT a HTML

Estructura de peticiones de SaltOS

SaltOS usa 3 variables en las peticiones para indicar al servidor que tarea desea realizar:

  • page: esta variable indica a SaltOS que aplicación se desea usar.
    • para que un valor de page sea válido, debe existir un fichero con el mismo nombre de tipo XML en el directorio xml.
  • action: esta variable indica a SaltOS que nodo del XML que define la aplicación se desea usar.
    • para que un valor de action sea válido, debe existir un fichero con el mismo nombre de tipo PHP en el directorio php/action.
  • id: esta variable indica a SaltOS sobre que registro se desea operar. Puede contener 3 posibles rangos de valores:
    • negativo: un valor negativo para el id, indica a SaltOS que debe mostrar la vista de consulta.
    • cero: un valor negativo para el id, indica a SaltOS que debe mostrar la vista para crear nuevos registros.
    • positivo: un valor positivo para el id, indica a SaltOS que debe mostrar la vista para modificar registros.

En los ejemplos anteriores se han explicado los "actions" que vienen por defecto en el core de SaltOS, pero si un desarrollador necesita crear nuevos actions, lo puede hacer de forma sencilla:

  <?php
  if(!check_user()) action_denied();
  if($page=="example") {
  	.
  	.
  	.
  	/* AQUI HACER LO QUE SE DESEE USANDO PHP */
  	.
  	.
  	.
  	die();
  }
  ?>

Se trata de un fragmento de código PHP y se pueden observar las siguientes características:

  • La primera línea útil de código comprueba si el usuario esta activo en el sistema, es decir, si ha hecho login previamente y correctamente.
  • La segunda línea sirve para detectar que este actión sólo se debe ejecutar cuando el origen sea la página example.
  • Al final del action, se debe finalizar la ejecución del script mediante die(). En caso contrario SaltOS nos mostrará un mensaje de error indicando que no se ha encontrado ningún action válido.


Líneas de XML
55,003
Líneas de PHP
13,896
Líneas de JS
6,243
Líneas de T2T
3,499
Líneas de XSLT
2,645
Líneas de SQL
1,477