Inheritance diagram for ilAssOrderingFormValuesObjectsConverter:

Collaboration diagram for ilAssOrderingFormValuesObjectsConverter:

Public Member Functions
	getContext ()

	setContext ($context)

	getPostVar ()

	setPostVar ($postVar)

	getImageRemovalCommand ()

	setImageRemovalCommand ($imageRemovalCommand)

	getImageUrlPath ()

	setImageUrlPath ($imageUrlPath)

	getImageFsPath ()

	setImageFsPath ($imageFsPath)

	getThumbnailPrefix ()

	setThumbnailPrefix ($thumbnailPrefix)

	getIndentationsPostVar ()

	manipulateFormInputValues ($elementsOrValues)

	manipulateFormSubmitValues ($valuesOrElements)

	constructElementsFromValues (array $values)

Data Fields
const	INDENTATIONS_POSTVAR_SUFFIX = '_ordering'

const	INDENTATIONS_POSTVAR_SUFFIX_JS = '__default'

const	CONTEXT_MAINTAIN_ELEMENT_TEXT = 'maintainItemText'

const	CONTEXT_MAINTAIN_ELEMENT_IMAGE = 'maintainItemImage'

const	CONTEXT_MAINTAIN_HIERARCHY = 'maintainHierarchy'

Protected Member Functions
	needsConvertToValues ($elementsOrValues)

	collectValuesFromElements (array $elements)

	getTextContentValueFromObject (ilAssOrderingElement $element)

	getImageContentValueFromObject (ilAssOrderingElement $element)

	getStructValueFromObject (ilAssOrderingElement $element)

	needsConvertToElements ($valuesOrElements)

	fetchSubmittedImageFilename ($identifier)

	fetchSubmittedUploadFilename ($identifier)

	fetchSubmittedFileUploadProperty ($fileUpload, $property)

	fetchElementFileUpload ($identifier)

	fetchSubmittedUploadFiles ()

	getFileSubmitsHavingActualUpload ($submittedUploadFiles)

	getFileSubmitDataRestructuredByIdentifiers ()

	getFileSubmitData ()

	wasImageRemovalRequested ($identifier)

Protected Attributes
	$context = null

	$postVar = null

	$imageRemovalCommand = null

	$imageUrlPath

	$imageFsPath

	$thumbnailPrefix

Detailed Description

Definition at line 12 of file class.ilAssOrderingFormValuesObjectsConverter.php.

Member Function Documentation

◆ collectValuesFromElements()

ilAssOrderingFormValuesObjectsConverter::collectValuesFromElements ( array $elements )

protected

Definition at line 176 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, getContext(), getImageContentValueFromObject(), getStructValueFromObject(), and getTextContentValueFromObject().

Referenced by manipulateFormInputValues().

         {
                 $values = array();
                 
                 foreach($elements as $identifier => $orderingElement)
                 {
                         switch( $this->getContext() )
                         {
                                 case self::CONTEXT_MAINTAIN_ELEMENT_TEXT:
                                         
                                         $values[$identifier] = $this->getTextContentValueFromObject($orderingElement);
                                         break;
                                 
                                 case self::CONTEXT_MAINTAIN_ELEMENT_IMAGE:
                                         
                                         $values[$identifier] = $this->getImageContentValueFromObject($orderingElement);
                                         break;
                                 
                                 case self::CONTEXT_MAINTAIN_HIERARCHY:
                                         
                                         $values[$identifier] = $this->getStructValueFromObject($orderingElement);
                                         break;
                                 
                                 default:
                                         throw new ilFormException('unsupported context: '.$this->getContext());
                         }
                 }
                 
                 return $values;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ constructElementsFromValues()

ilAssOrderingFormValuesObjectsConverter::constructElementsFromValues ( array $values )

Definition at line 255 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, fetchSubmittedImageFilename(), fetchSubmittedUploadFilename(), getContext(), and wasImageRemovalRequested().

Referenced by manipulateFormSubmitValues().

         {
                 $elements = array();
                 
                 $position = 0;
                 
                 foreach($values as $identifier => $value)
                 {
                         $element = new ilAssOrderingElement();
                         $element->setRandomIdentifier($identifier);
                         
                         $element->setPosition($position++);
                         
                         if( $this->getContext() == self::CONTEXT_MAINTAIN_HIERARCHY )
                         {
                                 $element->setIndentation($value);
                         }
                         else
                         {
                                 $element->setContent($value);
                         }
                         
                         if( $this->getContext() == self::CONTEXT_MAINTAIN_ELEMENT_IMAGE )
                         {
                                 $element->setUploadImageName($this->fetchSubmittedImageFilename($identifier));
                                 $element->setUploadImageFile($this->fetchSubmittedUploadFilename($identifier));
                                 
                                 $element->setImageRemovalRequest($this->wasImageRemovalRequested($identifier));
                         }
                         
                         $elements[$identifier] = $element;
                 }
                 
                 return $elements;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchElementFileUpload()

ilAssOrderingFormValuesObjectsConverter::fetchElementFileUpload ( $identifier )

protected

Definition at line 313 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, and fetchSubmittedUploadFiles().

Referenced by fetchSubmittedImageFilename(), and fetchSubmittedUploadFilename().

         {
                 $uploadFiles = $this->fetchSubmittedUploadFiles();
                 
                 if( !isset($uploadFiles[$identifier]) )
                 {
                         return array();
                 }
                 
                 return $uploadFiles[$identifier];
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchSubmittedFileUploadProperty()

ilAssOrderingFormValuesObjectsConverter::fetchSubmittedFileUploadProperty	(	$fileUpload,
		$property
	)

protected

Definition at line 303 of file class.ilAssOrderingFormValuesObjectsConverter.php.

Referenced by fetchSubmittedImageFilename(), and fetchSubmittedUploadFilename().

         {
                 if( !isset($fileUpload[$property]) || !strlen($fileUpload[$property]) )
                 {
                         return null;
                 }
                 
                 return $fileUpload[$property];
         }

Here is the caller graph for this function:

◆ fetchSubmittedImageFilename()

ilAssOrderingFormValuesObjectsConverter::fetchSubmittedImageFilename ( $identifier )

protected

Definition at line 291 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References fetchElementFileUpload(), and fetchSubmittedFileUploadProperty().

Referenced by constructElementsFromValues().

         {
                 $fileUpload = $this->fetchElementFileUpload($identifier);
                 return $this->fetchSubmittedFileUploadProperty($fileUpload, 'name');
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchSubmittedUploadFilename()

ilAssOrderingFormValuesObjectsConverter::fetchSubmittedUploadFilename ( $identifier )

protected

Definition at line 297 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References fetchElementFileUpload(), and fetchSubmittedFileUploadProperty().

Referenced by constructElementsFromValues().

         {
                 $fileUpload = $this->fetchElementFileUpload($identifier);
                 return $this->fetchSubmittedFileUploadProperty($fileUpload, 'tmp_name');
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchSubmittedUploadFiles()

ilAssOrderingFormValuesObjectsConverter::fetchSubmittedUploadFiles ( )

protected

Definition at line 325 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References getFileSubmitDataRestructuredByIdentifiers().

Referenced by fetchElementFileUpload().

         {
                 $submittedUploadFiles = $this->getFileSubmitDataRestructuredByIdentifiers();
                 //$submittedUploadFiles = $this->getFileSubmitsHavingActualUpload($submittedUploadFiles);
                 return $submittedUploadFiles;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getContext()

ilAssOrderingFormValuesObjectsConverter::getContext ( )

Returns: string

Definition at line 54 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $context.

Referenced by collectValuesFromElements(), and constructElementsFromValues().

         {
                 return $this->context;
         }

Here is the caller graph for this function:

◆ getFileSubmitData()

ilAssOrderingFormValuesObjectsConverter::getFileSubmitData ( )

protected

Definition at line 381 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, and getPostVar().

Referenced by getFileSubmitDataRestructuredByIdentifiers().

         {
                 if( !isset($_FILES[$this->getPostVar()]) )
                 {
                         return array();
                 }
                 
                 return $_FILES[$this->getPostVar()];
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFileSubmitDataRestructuredByIdentifiers()

ilAssOrderingFormValuesObjectsConverter::getFileSubmitDataRestructuredByIdentifiers ( )

protected

Returns: array

Definition at line 361 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, and getFileSubmitData().

Referenced by fetchSubmittedUploadFiles().

         {
                 $submittedUploadFiles = array();
                 
                 foreach( $this->getFileSubmitData() as $uploadProperty => $valueElement )
                 {
                         foreach( $valueElement as $elementIdentifier => $uploadValue )
                         {
                                 if( !isset( $submittedUploadFiles[$elementIdentifier] ) )
                                 {
                                         $submittedUploadFiles[$elementIdentifier] = array();
                                 }
                                 
                                 $submittedUploadFiles[$elementIdentifier][$uploadProperty] = $uploadValue;
                         }
                 }
                 
                 return $submittedUploadFiles;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFileSubmitsHavingActualUpload()

ilAssOrderingFormValuesObjectsConverter::getFileSubmitsHavingActualUpload ( $submittedUploadFiles )

protected

Definition at line 332 of file class.ilAssOrderingFormValuesObjectsConverter.php.

         {
                 foreach($submittedUploadFiles as $identifier => $uploadProperties)
                 {                       
                         if( !isset($uploadProperties['tmp_name']) )
                         {
                                 unset($submittedUploadFiles[$identifier]);
                                 continue;
                         }
                         
                         if( !strlen($uploadProperties['tmp_name']) )
                         {
                                 unset($submittedUploadFiles[$identifier]);
                                 continue;
                         }
                         
                         if( !is_uploaded_file($uploadProperties['tmp_name']) )
                         {
                                 unset($submittedUploadFiles[$identifier]);
                                 continue;
                         }
                 }
                 
                 return $submittedUploadFiles;
         }

◆ getImageContentValueFromObject()

ilAssOrderingFormValuesObjectsConverter::getImageContentValueFromObject ( ilAssOrderingElement $element )

protected

Definition at line 212 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, ilAssOrderingElement\getContent(), getImageFsPath(), getImageUrlPath(), ilAssOrderingElement\getPresentationImageUrl(), getThumbnailPrefix(), ilAssOrderingElement\setImagePathFs(), ilAssOrderingElement\setImagePathWeb(), and ilAssOrderingElement\setImageThumbnailPrefix().

Referenced by collectValuesFromElements().

         {
                 $element->setImagePathWeb($this->getImageUrlPath());
                 $element->setImagePathFs($this->getImageFsPath());
                 $element->setImageThumbnailPrefix($this->getThumbnailPrefix());
                 
                 return array(
                         'title' => $element->getContent(),
                         'src' => $element->getPresentationImageUrl()
                 );
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getImageFsPath()

ilAssOrderingFormValuesObjectsConverter::getImageFsPath ( )

Returns: string

Definition at line 118 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageFsPath.

Referenced by getImageContentValueFromObject().

         {
                 return $this->imageFsPath;
         }

Here is the caller graph for this function:

◆ getImageRemovalCommand()

ilAssOrderingFormValuesObjectsConverter::getImageRemovalCommand ( )

Returns: null

Definition at line 86 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageRemovalCommand.

Referenced by wasImageRemovalRequested().

         {
                 return $this->imageRemovalCommand;
         }

Here is the caller graph for this function:

◆ getImageUrlPath()

ilAssOrderingFormValuesObjectsConverter::getImageUrlPath ( )

Returns: string

Definition at line 102 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageUrlPath.

Referenced by getImageContentValueFromObject().

         {
                 return $this->imageUrlPath;
         }

Here is the caller graph for this function:

◆ getIndentationsPostVar()

ilAssOrderingFormValuesObjectsConverter::getIndentationsPostVar ( )

Definition at line 147 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $postVar, and getPostVar().

         {
                 $postVar = $this->getPostVar();
                 $postVar .= self::INDENTATIONS_POSTVAR_SUFFIX;
                 $postVar .= self::INDENTATIONS_POSTVAR_SUFFIX_JS;
                 
                 return $postVar;
         }

Here is the call graph for this function:

◆ getPostVar()

ilAssOrderingFormValuesObjectsConverter::getPostVar ( )

Returns: string

Definition at line 70 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $postVar.

Referenced by getFileSubmitData(), getIndentationsPostVar(), and wasImageRemovalRequested().

         {
                 return $this->postVar;
         }

Here is the caller graph for this function:

◆ getStructValueFromObject()

ilAssOrderingFormValuesObjectsConverter::getStructValueFromObject ( ilAssOrderingElement $element )

protected

Definition at line 224 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References array, ilAssOrderingElement\getContent(), ilAssOrderingElement\getId(), ilAssOrderingElement\getIndentation(), ilAssOrderingElement\getPosition(), ilAssOrderingElement\getRandomIdentifier(), and string.

Referenced by collectValuesFromElements().

         {
                 return array(
                         'answer_id' => $element->getId(),
                         'random_id' => $element->getRandomIdentifier(),
                         'content' => (string)$element->getContent(),
                         'ordering_position' => $element->getPosition(),
                         'ordering_indentation' => $element->getIndentation()
                 );
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTextContentValueFromObject()

ilAssOrderingFormValuesObjectsConverter::getTextContentValueFromObject ( ilAssOrderingElement $element )

protected

Definition at line 207 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References ilAssOrderingElement\getContent().

Referenced by collectValuesFromElements().

         {
                 return $element->getContent();
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getThumbnailPrefix()

ilAssOrderingFormValuesObjectsConverter::getThumbnailPrefix ( )

Returns: string

Definition at line 134 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $thumbnailPrefix.

Referenced by getImageContentValueFromObject().

         {
                 return $this->thumbnailPrefix;
         }

Here is the caller graph for this function:

◆ manipulateFormInputValues()

ilAssOrderingFormValuesObjectsConverter::manipulateFormInputValues ( $inputValues )

Parameters

array $inputValues

Returns: array $inputValues

Implements ilFormValuesManipulator.

Definition at line 166 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References collectValuesFromElements(), and needsConvertToValues().

         {
                 if( $this->needsConvertToValues($elementsOrValues) )
                 {
                         $elementsOrValues = $this->collectValuesFromElements($elementsOrValues);
                 }
                 
                 return $elementsOrValues;
         }

Here is the call graph for this function:

◆ manipulateFormSubmitValues()

ilAssOrderingFormValuesObjectsConverter::manipulateFormSubmitValues ( $submitValues )

Parameters

array $submitValues

Returns: array $submitValues

Implements ilFormValuesManipulator.

Definition at line 245 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References constructElementsFromValues(), and needsConvertToElements().

         {
                 if( $this->needsConvertToElements($valuesOrElements) )
                 {
                         $valuesOrElements = $this->constructElementsFromValues($valuesOrElements);
                 }
                 
                 return $valuesOrElements;
         }

Here is the call graph for this function:

◆ needsConvertToElements()

ilAssOrderingFormValuesObjectsConverter::needsConvertToElements ( $valuesOrElements )

protected

Definition at line 235 of file class.ilAssOrderingFormValuesObjectsConverter.php.

Referenced by manipulateFormSubmitValues().

         {
                 if( !count($valuesOrElements) )
                 {
                         return false;
                 }
                 
                 return !( current($valuesOrElements) instanceof ilAssOrderingElement );
         }

Here is the caller graph for this function:

◆ needsConvertToValues()

ilAssOrderingFormValuesObjectsConverter::needsConvertToValues ( $elementsOrValues )

protected

Definition at line 156 of file class.ilAssOrderingFormValuesObjectsConverter.php.

Referenced by manipulateFormInputValues().

         {
                 if( !count($elementsOrValues) )
                 {
                         return false;
                 }
                 
                 return ( current($elementsOrValues) instanceof ilAssOrderingElement );
         }

Here is the caller graph for this function:

◆ setContext()

ilAssOrderingFormValuesObjectsConverter::setContext ( $context )

Parameters

$context

Definition at line 62 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $context.

         {
                 $this->context = $context;
         }

◆ setImageFsPath()

ilAssOrderingFormValuesObjectsConverter::setImageFsPath ( $imageFsPath )

Parameters

string $imageFsPath

Definition at line 126 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageFsPath.

         {
                 $this->imageFsPath = $imageFsPath;
         }

◆ setImageRemovalCommand()

ilAssOrderingFormValuesObjectsConverter::setImageRemovalCommand ( $imageRemovalCommand )

Parameters

null $imageRemovalCommand

Definition at line 94 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageRemovalCommand.

         {
                 $this->imageRemovalCommand = $imageRemovalCommand;
         }

◆ setImageUrlPath()

ilAssOrderingFormValuesObjectsConverter::setImageUrlPath ( $imageUrlPath )

Parameters

string $imageUrlPath

Definition at line 110 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageUrlPath.

         {
                 $this->imageUrlPath = $imageUrlPath;
         }

◆ setPostVar()

ilAssOrderingFormValuesObjectsConverter::setPostVar ( $postVar )

Parameters

$postVar

Definition at line 78 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $postVar.

         {
                 $this->postVar = $postVar;
         }

◆ setThumbnailPrefix()

ilAssOrderingFormValuesObjectsConverter::setThumbnailPrefix ( $thumbnailPrefix )

Parameters

string $thumbnailPrefix

Definition at line 142 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $thumbnailPrefix.

         {
                 $this->thumbnailPrefix = $thumbnailPrefix;
         }

◆ wasImageRemovalRequested()

ilAssOrderingFormValuesObjectsConverter::wasImageRemovalRequested ( $identifier )

protected

Definition at line 391 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $_POST, getImageRemovalCommand(), and getPostVar().

Referenced by constructElementsFromValues().

         {
                 if( !$this->getImageRemovalCommand() )
                 {
                         return false;
                 }
                 
                 if( !isset($_POST['cmd']) || !is_array($_POST['cmd']) )
                 {
                         return false;
                 }
                 
                 $cmdArr = $_POST['cmd'];
                 
                 if( !isset($cmdArr[$this->getImageRemovalCommand()]) )
                 {
                         return false;
                 }
                 
                 $fieldArr = $cmdArr[$this->getImageRemovalCommand()];
                         
                 if( !isset($fieldArr[$this->getPostVar()]) )
                 {
                         return false;
                 }
                 
                 $identifierArr = $fieldArr[$this->getPostVar()];
         
                 return key($identifierArr) == $identifier;
         }