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 (array $input_values)

	manipulateFormSubmitValues (array $submitValues)

	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 ($elements_or_values)

	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)
	TODO: Instead of accessing post, the complete ilFormValuesManipulator should be aware of a server request or the corresponding processed input values. More...

Protected Attributes
	$context = null

	$postVar = null

	$imageRemovalCommand = null

	$imageUrlPath

	$imageFsPath

	$thumbnailPrefix

Detailed Description

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

Member Function Documentation

◆ collectValuesFromElements()

ilAssOrderingFormValuesObjectsConverter::collectValuesFromElements ( array $elements )

protected

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

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

Referenced by manipulateFormInputValues().

                                                                  : array
     {
         $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 253 of file class.ilAssOrderingFormValuesObjectsConverter.php.

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

Referenced by manipulateFormSubmitValues().

                                                               : array
     {
         $elements = array();
 
         $position = 0;
 
         if (array_key_exists('content', $values)) {
             $values = $values['content'];
         }
         foreach ($values as $identifier => $value) {
             $element = new ilAssOrderingElement();
 
             $element->setRandomIdentifier($identifier);
 
             $element->setPosition($position++);
 
             if ($this->getContext() == self::CONTEXT_MAINTAIN_HIERARCHY) {
                 $element->setIndentation((int)$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 309 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References 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 300 of file class.ilAssOrderingFormValuesObjectsConverter.php.

Referenced by fetchSubmittedImageFilename(), and fetchSubmittedUploadFilename().

     {
         if (!array_key_exists($property, $fileUpload)) {
             return null;
         }
 
         return $fileUpload[$property];
     }

Here is the caller graph for this function:

◆ fetchSubmittedImageFilename()

ilAssOrderingFormValuesObjectsConverter::fetchSubmittedImageFilename ( $identifier )

protected

Definition at line 288 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 294 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 320 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References getFileSubmitDataRestructuredByIdentifiers().

Referenced by fetchElementFileUpload().

                                                   : array
     {
         $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 67 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $context.

Referenced by collectValuesFromElements(), and constructElementsFromValues().

                                 : ?string
     {
         return $this->context;
     }

Here is the caller graph for this function:

◆ getFileSubmitData()

ilAssOrderingFormValuesObjectsConverter::getFileSubmitData ( )

protected

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

References 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 352 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References getFileSubmitData().

Referenced by fetchSubmittedUploadFiles().

                                                                    : array
     {
         $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 327 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 ilAssOrderingElement\getContent(), getImageFsPath(), getImageUrlPath(), ilAssOrderingElement\getPresentationImageUrl(), getThumbnailPrefix(), ilAssOrderingElement\setImagePathFs(), ilAssOrderingElement\setImagePathWeb(), and ilAssOrderingElement\setImageThumbnailPrefix().

Referenced by collectValuesFromElements().

                                                                                     : array
     {
         $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 122 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $imageFsPath.

Referenced by getImageContentValueFromObject().

                                     : string
     {
         return $this->imageFsPath;
     }

Here is the caller graph for this function:

◆ getImageRemovalCommand()

ilAssOrderingFormValuesObjectsConverter::getImageRemovalCommand ( )

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

References $imageRemovalCommand.

Referenced by wasImageRemovalRequested().

                                             : ?string
     {
         return $this->imageRemovalCommand;
     }

Here is the caller graph for this function:

◆ getImageUrlPath()

ilAssOrderingFormValuesObjectsConverter::getImageUrlPath ( )

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

References $imageUrlPath.

Referenced by getImageContentValueFromObject().

                                      : string
     {
         return $this->imageUrlPath;
     }

Here is the caller graph for this function:

◆ getIndentationsPostVar()

ilAssOrderingFormValuesObjectsConverter::getIndentationsPostVar ( )

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

References $postVar, and getPostVar().

                                             : string
     {
         $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 83 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $postVar.

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

                                 : ?string
     {
         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 ilAssOrderingElement\getContent(), ilAssOrderingElement\getId(), ilAssOrderingElement\getIndentation(), ilAssOrderingElement\getPosition(), and ilAssOrderingElement\getRandomIdentifier().

Referenced by collectValuesFromElements().

                                                                               : array
     {
         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().

                                                                                    : ?string
     {
         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 138 of file class.ilAssOrderingFormValuesObjectsConverter.php.

References $thumbnailPrefix.

Referenced by getImageContentValueFromObject().

                                         : string
     {
         return $this->thumbnailPrefix;
     }

Here is the caller graph for this function:

◆ manipulateFormInputValues()

ilAssOrderingFormValuesObjectsConverter::manipulateFormInputValues ( array $input_values )

Implements ilFormValuesManipulator.

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

References collectValuesFromElements(), and needsConvertToValues().

                                                                   : array
     {
         if ($this->needsConvertToValues($input_values)) {
             $input_values = $this->collectValuesFromElements($input_values);
         }
 
         return $input_values;
     }

Here is the call graph for this function:

◆ manipulateFormSubmitValues()

ilAssOrderingFormValuesObjectsConverter::manipulateFormSubmitValues ( array $submitValues )

Implements ilFormValuesManipulator.

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

References constructElementsFromValues(), and needsConvertToElements().

                                                                    : array
     {
         if ($this->needsConvertToElements($submitValues)) {
             $submitValues = $this->constructElementsFromValues($submitValues);
         }
 
         return $submitValues;
     }

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().

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

Here is the caller graph for this function:

◆ needsConvertToValues()

ilAssOrderingFormValuesObjectsConverter::needsConvertToValues ( $elements_or_values )

protected

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

Referenced by manipulateFormInputValues().

                                                                 : bool
     {
         if (!count($elements_or_values)) {
             return false;
         }
 
         return (current($elements_or_values) instanceof ilAssOrderingElement);
     }

Here is the caller graph for this function:

◆ setContext()

ilAssOrderingFormValuesObjectsConverter::setContext ( $context )

Parameters

$context

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

References $context.

                                         : void
     {
         $this->context = $context;
     }

◆ setImageFsPath()

ilAssOrderingFormValuesObjectsConverter::setImageFsPath ( $imageFsPath )

Parameters

string $imageFsPath

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

References $imageFsPath.

                                                 : void
     {
         $this->imageFsPath = $imageFsPath;
     }

◆ setImageRemovalCommand()

ilAssOrderingFormValuesObjectsConverter::setImageRemovalCommand ( $imageRemovalCommand )

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

References $imageRemovalCommand.

                                                                 : void
     {
         $this->imageRemovalCommand = $imageRemovalCommand;
     }

◆ setImageUrlPath()

ilAssOrderingFormValuesObjectsConverter::setImageUrlPath ( $imageUrlPath )

Parameters

string $imageUrlPath

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

References $imageUrlPath.

                                                   : void
     {
         $this->imageUrlPath = $imageUrlPath;
     }

◆ setPostVar()

ilAssOrderingFormValuesObjectsConverter::setPostVar ( $postVar )

Parameters

$postVar

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

References $postVar.

                                         : void
     {
         $this->postVar = $postVar;
     }

◆ setThumbnailPrefix()

ilAssOrderingFormValuesObjectsConverter::setThumbnailPrefix ( $thumbnailPrefix )

Parameters

string $thumbnailPrefix

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

References $thumbnailPrefix.

                                                         : void
     {
         $this->thumbnailPrefix = $thumbnailPrefix;
     }

◆ wasImageRemovalRequested()

ilAssOrderingFormValuesObjectsConverter::wasImageRemovalRequested ( $identifier )

protected

TODO: Instead of accessing post, the complete ilFormValuesManipulator should be aware of a server request or the corresponding processed input values.

Parameters

$identifier

Returns: bool

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

References getImageRemovalCommand(), getPostVar(), and ilIdentifiedMultiValuesJsPositionIndexRemover\IDENTIFIER_INDICATOR_PREFIX.

Referenced by constructElementsFromValues().

                                                             : bool
     {
         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()];
 
         $requested_identfier = key($identifierArr);
 
         // The code actually relied on a manipulation of $_POST by ilIdentifiedMultiValuesJsPositionIndexRemover
         return (string) str_replace(
             ilIdentifiedMultiValuesJsPositionIndexRemover::IDENTIFIER_INDICATOR_PREFIX,
             '',
             (string) $requested_identfier
         ) === (string) $identifier;
     }