campo booleano tipo de alojamiento Drupal
Coloque campos de datos personalizados a las entidades de Drupal.
La API permite Campo campos de datos personalizados que se adjunta a las entidades de Drupal y se encarga de almacenar, cargar, editar y renderizar los datos de campo. Cualquier tipo de entidad (nodo, usuario, etc.) puede utilizar la API de campo para hacer sí "fieldable" y por lo tanto permitir que los campos que deben adjuntarse a la misma. Otros módulos pueden proporcionar una interfaz de usuario para la gestión de campos personalizados a través de un navegador web, así como una amplia y flexible variedad de tipo de datos, elemento de formulario, y las capacidades de formato de visualización.
El API campo define dos estructuras primarias de datos, el campo y ejemplo, y el concepto de un paquete. Un Campo define un tipo particular de datos que se puede conectar a las entidades. Una instancia de campo es un campo unido a un solo paquete. Un paquete es un conjunto de campos que son tratados como un grupo por el campo Adjuntar API y se relaciona con un único tipo de entidad fieldable.
Por ejemplo, supongamos que un administrador del sitio quiere nodos Artículo tener un subtítulo y una foto. El uso de la API de Campo o módulo de interfaz de usuario de campo, el administrador crea un campo denominado 'subtítulo' del tipo 'texto' y un campo denominado 'foto' 'imagen' tipo de. El administrador (de nuevo, a través de una interfaz de usuario) crea dos instancias de campos, uno que sujetan el campo 'subtítulo' a la 'nodo' paquete 'artículo' y uno unir el campo 'foto' a la 'nodo' paquete 'artículo'. Cuando el sistema de nodo utiliza el campo Adjuntar API para cargar todos los campos para un nodo artículo, pasa tipo de entidad del nodo (que es 'nodo') y tipo de contenido (que es 'artículo') como paquete del nodo. field_attach_load () a continuación, carga el 'subtítulo' y los campos 'foto' porque están ambos unidos a la 'artículo' 'nodo' paquete.
las definiciones de campo son representados como una serie de pares clave / valor.
- id (número entero, de sólo lectura). El identificador primario del campo. Se le asigna automáticamente por field_create_field ().
- nombre_campo (cadena). El nombre del campo. Cada nombre de campo es único dentro de la API de campo. Cuando un campo está unido a una entidad, los datos del campo se almacena en $ entidad -> $ nombre_campo. La longitud máxima es de 32 caracteres.
- Tipo (cadena). El tipo de campo, tales como 'texto' o 'imagen'. Los tipos de campo son definidas por módulos que implementan hook_field_info ().
- entity_types (array). El conjunto de tipos de entidades que pueden contener instancias de este campo. Si se especifica vacía o no, el campo puede tener instancias de cualquier tipo de entidad.
- cardinalidad (número entero). El número de valores del campo puede contener. Los valores válidos son cualquier número entero positivo o FIELD_CARDINALITY_UNLIMITED.
- traducible (integer). Si el campo es traducible.
- bloqueado (número entero). Si el campo está disponible para su edición. Si es TRUE, los usuarios no pueden cambiar la configuración de campo o crear nuevas instancias del campo en la interfaz de usuario. El valor predeterminado es falso.
- módulo (cadena, de sólo lectura). El nombre del módulo que implementa el tipo de campo.
- activo (número entero, de sólo lectura). TRUE si el módulo que implementa el tipo de campo está actualmente activado, de lo contrario.
- suprimido (número entero, de sólo lectura). TRUE si este campo ha sido eliminado, de lo contrario. campos eliminados son ignorados por el campo Adjuntar API. Esta propiedad existe porque los campos pueden ser marcados para su eliminación, pero en realidad sólo destruidas por un proceso de recolección de basura separada.
- columnas (array, de sólo lectura). Una matriz de las columnas de la API de campo utilizado para almacenar cada valor de este campo. La lista de columnas puede depender de la configuración del campo; no es constante según el tipo de campo. especificaciones de la columna de la API de campo son exactamente iguales a las especificaciones API de esquema de columna, pero, dependiendo del módulo de almacenamiento de campo en uso, el nombre de la columna no puede representar una columna en una base de datos SQL.
- índices (array). Una serie de índices en columnas de datos, utilizando el mismo formato de definición de las especificaciones de índice API de esquema. Sólo se permiten las columnas que aparecen en el entorno 'columnas'. Tenga en cuenta que los tipos de campo puede especificar índices predeterminados, que pueden ser modificados o añadidos a la hora de crear un campo.
- llaves extranjeras. (Opcional) Una matriz asociativa de las relaciones, usando la misma estructura que hook_schema definición de las 'claves externas' (). Tenga en cuenta, sin embargo, que los datos de campo no necesariamente se almacena en SQL. Además, el posible uso es limitado, ya que no se puede especificar otro campo, como las tablas de SQL única existentes relacionados, tales como formatos de filtro.
- configuración (array). Un sub-matriz de pares clave / valor de configuración de campo de tipo específico. Cada módulo de tipo de campo define y documenta sus propios ajustes de campo.
- almacenamiento (array). Un sub-array de pares clave / valor que identifica el backend de almacenamiento a utilizar para el para el campo:
- Tipo (cadena). El backend de almacenamiento utilizado por el campo. backends de almacenamiento están definidos por los módulos que implementan hook_field_storage_info ().
- módulo (cadena, de sólo lectura). El nombre del módulo que implementa el servidor de almacenamiento.
- activo (número entero, de sólo lectura). TRUE si el módulo que implementa el servidor de almacenamiento está habilitado, de lo contrario.
- configuración (array). Un sub-matriz de pares clave / valor de configuración. Cada backend de almacenamiento define y documenta su propia configuración.
definiciones instancia de campo se representan como una serie de pares clave / valor.
- id (número entero, de sólo lectura). El identificador de principal de esta instancia de campo. Se le asigna automáticamente por field_create_instance ().
- field_id (entero, de sólo lectura). La clave externa del campo unido al paquete por esta instancia. Se rellena automáticamente por field_create_instance ().
- nombre_campo (cadena). El nombre del campo adjunta al paquete por esta instancia.
- entity_type (cadena). El nombre del tipo de entidad la instancia está unido a.
- haz (string). El nombre del paquete de que el campo está unido a.
- etiqueta (string). Una etiqueta legible para el campo cuando se utiliza con este paquete. Por ejemplo, la etiqueta será el título de elementos API formulario para este ejemplo.
- Descripción (cadena). Una descripción legible por humanos para el campo cuando se utiliza con este paquete. Por ejemplo, la descripción será el texto de ayuda de elementos de la API de formularios para este caso.
- requerida (número entero). TRUE si se requiere un valor para este campo cuando se utiliza con este paquete, de lo contrario. Actualmente, sólo se requiere-dad se aplica durante las operaciones de API de formulario, no por field_attach_load (), field_attach_insert (), o field_attach_update ().
- default_value_function (cadena). El nombre de la función, en su caso, que proporcionará un valor predeterminado.
- default_value (array). Si default_value_function no está definida, se pueden proporcionar valores fijos a continuación.
- suprimido (número entero, de sólo lectura). TRUE si este caso se ha eliminado, de lo contrario. casos eliminados son ignorados por el campo Adjuntar API. Esta propiedad existe porque los casos pueden ser marcados para su eliminación, pero en realidad sólo destruidas por un proceso de recolección de basura separada.
- configuración (array). Un sub-matriz de pares clave / valor de configuración de instancia de campo de tipo específico. Cada módulo de tipo de campo define y documenta su propia configuración de instancia.
- Widget (array). Un sub-array de pares clave / valor que identifica el widget de entrada Form API para el campo cuando es utilizado por este paquete:
- Tipo (cadena). El tipo del widget, como text_textfield. tipos Widget se definen por módulos que implementan hook_field_widget_info ().
- configuración (array). Un sub-matriz de pares clave / valor de configuración del widget de tipo específico. Cada módulo de campo de tipo de widget define y documenta sus propios ajustes del widget.
- peso (float). El peso del widget con relación a los otros elementos en entidad formularios de edición.
- módulo (cadena, de sólo lectura). El nombre del módulo que implementa el tipo de widget.
Los (por defecto) rinda matrices producidas para casos de campo están documentados en field_attach_view ().
Manojos están representados por dos cuerdas, un tipo de entidad y un nombre de paquete.
- API campo CRUD. Crear, actualizaciones y eliminaciones campos, paquetes (también conocido como "tipos de contenido"), e instancias. Módulos utilizan esta API, a menudo en hook_install (), para crear estructuras de datos personalizados.
- El campo Adjuntar API. Se conecta los tipos de entidad a la API de campo. El campo Adjuntar carga funciones de API, almacenar, generar estructuras Form API, visualización, y realizar una variedad de otras funciones para datos de campo conectados a entidades individuales. tipos de entidad Fieldable como nodo y usuarios utilizan esta API para hacerse fieldable.
- Campo Info API. Expone información sobre todos los campos, instancias, widgets, y la información relacionada definidos por o con la API de campo.
- API de almacenamiento de campo. Proporciona un sistema de almacenamiento de back-end enchufable para los datos reales de campo. La implementación por defecto, field_sql_storage.module. datos de campo almacena en la base de datos SQL local.
- API Campo de eliminación de datos mayor. Se limpia después de las operaciones de eliminación en masa tales como field_delete_field () y field_delete_instance ().
- API lengua campo. Proporciona soporte multilingüe nativo para la API de campo.