What is a gadget?

A gadget is an enhancement or addition to your website.

Any gadget will be using a model which will return the data in different formats: arrays, integers, strings, booleans, etc.

Think of a gadget as a module. For example, imagine that you are running a Point of Sale in Jaws, so, to run this Point of Sale you need some sections: once to manage your sales, another for customers, another for accounting, etc. Each of this sections are what we call a gadget.

In our case some gadgets are: Blog, Phoo, FileBrowser, etc.


What is a gadget from the MVC point of view?

You can get confused with some terms we manage in Jaws. We’ve defined a gadget. Now here comes the definition of a gadget from the MVC point of view (remember that Jaws uses MVC as a design pattern).

If you read the documentation of MVC, you must know that any application based on this pattern must have: controllers, views and models. In Jaws the view for the HTML view (what you see in your browser) is named: gadget.

To be more clear, lets suppose you have a gadget (a section) for your customers:

  • First of all, you need a directory named Customers inside gadgets directory (for example: html/gadgets/Customers).
  • Inside that directory (html/gadgets/Customers) you will have some other files and directories: CustomersModel.php (the model, CustomersRestWebservice.php (the REST webservice) and Customers.php, this last one will be the gadget, that you will see JUST in your browser.

As you have seen, the Customers.php will be the gadget file, the HTML view.

If you are going to develop a gadget, there are some rules for gadgets:

  • The directory where you have your gadget must be of the same name. So if your gadget’s name is Customers, then your gadget’s directory is going to be: Customers.
  • Your gadget’s file (HTML view) needs to have the same name, so again, if your gadget’s name is Customers, then your gadget’s file is going to be: Customers.php and must be inside Customers directory (inside gadgets/ directory).

Que es un gadget?

Traduccion al español por JAHS

Un gadget es un complemento o adición a su sitio web.

Cada gadget hace uso de un modelo el cual regresa los datos en distintos formatos: arrays, integers, strings, booleans, etc. Piense en un gadget como en un modulo. Por ejemplo, imagine que Ud. se encuentra corriendo un Punto de venta en Jaws, de modo que, para correr ese punto de venta Ud. requiere algunas secciones: una para manejar las ventas, otra para clientes, otra para manejo de cuentas, etc. Cada una des estas secciones es lo que nosotros llamaríamos un Gadget.

En nuestro caso algunos gadgets son: Blog, Phoo, FileBrowser, etc;

Que es un gadget desde el punto de vista MVC?

Ud. podría llegar a sentirse confuso con algunos términos que manejamos en Jaws. Ya que hemos definido un gadget, ahora definiremos un gadget desde el punto de vista de MVC (Recuerde que Jaws utiliza MVC como patrón de diseño).

Si Ud. lee la documentación de MVC, se dará cuenta que cada aplicación basada en este modelo deber contener: controladores, vistas y modelos. En Jaws la vista para HTML (Lo que Ud. ve en su navegador) es llamado: gadget.

Para ser mas claro, vamos a suponer que Ud. dispone de un gadget (una sección) para sus clientes: Primero que nada necesitara un directorio llamado “Clientes” dentro del directorio gadgets (por ejemplo: html/gadgets/Customers). Dentro de dicho directorio (html/gadgets/Customers) Ud. encontraría algunos otros archivos y directorios: ClientesModelo.php (el modelo) , ClientesRestWebservice.php (el servicio web REST) y clientes.php, este ultimo seria el gadget, seria lo que se mostraría en si navegador.

Como puede ver, el archivo Clientes.php seria el archivo gadget, la vista HTML.

Si Ud. va a desarrollar un gadget, existen algunas reglas para gadgets: El directorio donde se alojara el gadget debe tener el mismo nombre que el gadget. De modo que, si el gadget se llama clientes, entonces el directorio será…, ¡Adivino!: clientes.

El archivo gadget (Vista HTML) necesita tener el mismo nombre, así que nuevamente, si el nombre del gadget es clientes, entonces el archivo a usar será clientes.php y deberá encontrarse en el directorio clientes/ (dentro del directorio gadgets/)

 
  /var/www/wiki/htdocs/data/jaws/development/gadgets/whatis.txt · Last modified: 2007/11/02 16:27