Recibe información extraida del archivo de cuestionario, crea un objeto ItemsGroup y añade todos los items que lo forman.

También se encarga de crear el objeto Etiquetas del conjunto según la información recibida del archivo de texto.

package ItemsGroup
author Juan Haro
link http://jharo.net/dokuwiki/testmaker
copyright Copyright 2012 Juan Haro
license MIT License

 Methods

Crea un grupo y le añade los ítems que lo componen según la información recibida.

__construct(\type $id, \type $itemsGroupData) 

Opcionalmente puede recibir un objeto de etiquetas y el título que será asignado al conjunto.

Parameters

$id

\type

$itemsGroupData

\type

Añade un nuevo item al array de ítem.

addItem(\Item | string $item, \itemId $id) 
Inherited

La variable $item puede ser un objeto Item o bien una cadena de texto. Si la variable $item es una cadena de texto, crea un nuevo objeto ítem al que le asigna ese texto. Si no recibe identificador, se le asignará un identificador númerico (número de ítems + 1).

inherited_from \ItemsGroup::addItem()

Parameters

$item

\Itemstring

$id

\itemId

Añade un nuevo subconjunto.

addItemsSubGroup(\ItemsGroup $itemsSubGroup) 
Inherited
inherited_from \ItemsGroup::addItemsSubGroup()

Parameters

$itemsSubGroup

\ItemsGroup

getDescription()

getDescription() 
Inherited
inherited_from \ItemsGroup::getDescription()

Recupera las etiquetas contenidas en el objeto Etiquetas almacenado en la variable interna.

getEtiquetas() : \type
Inherited
inherited_from \ItemsGroup::getEtiquetas()

Returns

\type

Recupera el identificador completo de un ítem del conjunto.

getFullItemId(\Item $itemToFind) 
Inherited

El identificador completo se utiliza en el atributo 'name' de los elementos del formulario html. La búsqueda se realiza comparando el hash del ítem pasado con el hash de cada uno de los ítems del conjunto. Por ahora sólo acepta dos niveles de profundidad: Group_SubGroup_Item

inherited_from \ItemsGroup::getFullItemId()

Parameters

$itemToFind

getId()

getId() 
Inherited
inherited_from \ItemsGroup::getId()

getIdsFromTexto()

getIdsFromTexto() 
Inherited
inherited_from \ItemsGroup::getIdsFromTexto()

getImage()

getImage() 
Inherited
inherited_from \ItemsGroup::getImage()

getItems()

getItems() 
Inherited
inherited_from \ItemsGroup::getItems()

Devuelve los subconjuntos de ítems.

getItemsSubGroups() : array
Inherited
inherited_from \ItemsGroup::getItemsSubGroups()

Returns

array

getNewPage()

getNewPage() 
Inherited
inherited_from \ItemsGroup::getNewPage()

getTitle()

getTitle() 
Inherited
inherited_from \ItemsGroup::getTitle()

Carga un array de ítems o de subconjuntos en el conjunto.

loadAndAddElements() 

Busca en el array un campo con id DESCRIPTION_FIELD Si lo encuentra, lo asigna a $description.

loadDesctiption() 

Carga las etiquetas del archivo.

loadEtiquetas() 

Si el campo ETIQUETAS_FIELD tiene un valor numérico, genera tantas etiquetas como indica ese valor.

Comprueba si el campo IDS_FROM_TEXTO_FIELD se encuentra en el array.

loadIdsFromTexto() : boolean

Si el valor del campo es 's', el texto de cada ítem será utilizado como identificador (adaptándolo para suprimir caracteres extraños).

Returns

boolean

Busca en el array un campo con id IMAGE_FIELD Si lo encuentra, lo asigna a $image;

loadImage() 

Busca en el array un campo con id NEW_PAGE_FIELD Valores: 's' => True; otros => False

loadNewPage() 

Busca en el array un campo con id TITLE_FIELD Si lo encuentra, lo asigna a $title.

loadTitle() 

setDescription()

setDescription($description) 
Inherited
inherited_from \ItemsGroup::setDescription()

Parameters

$description

Crea un objeto de Etiquetas a partir de la información recibida.

setEtiquetas(\type $etiquetas) 
Inherited

También permite la asignación de un objeto Etiquetas.

inherited_from \ItemsGroup::setEtiquetas()

Parameters

$etiquetas

\type

setId()

setId($id) 
Inherited
inherited_from \ItemsGroup::setId()

Parameters

$id

$idsFromTexto = True | False

setIdsFromTexto(boolean $idsFromTexto) 
Inherited
inherited_from \ItemsGroup::setIdsFromTexto()

Parameters

$idsFromTexto

boolean

Recibe la ruta de la imagen.

setImage(string $image) 
Inherited
inherited_from \ItemsGroup::setImage()

Parameters

$image

string

$newPage = True | False

setNewPage(boolean $newPage) 
Inherited
inherited_from \ItemsGroup::setNewPage()

Parameters

$newPage

boolean

setTitle()

setTitle($title) 
Inherited
inherited_from \ItemsGroup::setTitle()

Parameters

$title

Devuelve el campo ítems del grupo.

getItemsFromGroupData() : array

Si no hay ítems, detiene la ejecución.

Returns

array

getItemsGroupData()

getItemsGroupData() 

itemsGroupData es el array con toda la información del grupo de items extraido del archivo.

setItemsGroupData(array $itemsGroupData) 

Parameters

$itemsGroupData

array

 Properties

 

$etiquetas : \Etiquetas
Inherited

Es un objeto de la clase Etiquetas. Se inicializa a NULL ya que puede existir un grupo de ítems que no contenga etiquetas (p.ej, si se compone de ítems con opción de respuesta múltiple).

inherited_from \ItemsGroup::$$etiquetas
 

$description : string
Inherited

Se muestra bajo el título.

inherited_from \ItemsGroup::$$description
 

$id : string
Inherited

Se utiliza para codificar los ítems. Ej. idGrupo__idPregunta

inherited_from \ItemsGroup::$$id
 

$idsFromTexto : boolean
Inherited
inherited_from \ItemsGroup::$$idsFromTexto
 

$image : string
Inherited
inherited_from \ItemsGroup::$$image
 

$items : array
Inherited
inherited_from \ItemsGroup::$$items
 

$itemsSubGroups 
Inherited
inherited_from \ItemsGroup::$$itemsSubGroups
 

$newPage : boolean
Inherited
inherited_from \ItemsGroup::$$newPage
 

$title : string
Inherited

Se muestra en el encabezado de cada conjunto.

inherited_from \ItemsGroup::$$title
 

$itemsGroupData 

 Constants

 

DESCRIPTION_FIELD

DESCRIPTION_FIELD 
 

ETIQUETAS_FIELD

ETIQUETAS_FIELD 
 

IDS_FROM_TEXTO_FIELD

IDS_FROM_TEXTO_FIELD 
 

Se utiliza en la vista para codificar el identificador de los items.

ID_DELIMITER 
Inherited

Ej.: grupo__item1 Ej.: grupo__subgrupo__item1

inherited_from \ItemsGroup::ID_DELIMITER
 

El identificador del elemento html donde se mostrára el conjunto de ítems.

ID_HTML 
Inherited

Se utiliza conjuntamente con un valor numérico para asignar el orden de los conjuntos de ítems mostrados en la plantilla html.

inherited_from \ItemsGroup::ID_HTML
 

IMAGE_FIELD

IMAGE_FIELD 
 

ITEMS_FIELD

ITEMS_FIELD 
 

Identificador por el que se comienzan a numerar los ítems

ITEM_ID_INICIO 
Inherited
inherited_from \ItemsGroup::ITEM_ID_INICIO
 

NEW_PAGE_FIELD

NEW_PAGE_FIELD 
 

Identificador por el que se comienzan a numerar los subconjuntos.

SUBGROUP_ID_INICIO 
Inherited
inherited_from \ItemsGroup::SUBGROUP_ID_INICIO
 

Campos del archivo de cuestionario

TITLE_FIELD