Initial commit

typo3conf/ext/vhs/Classes/ViewHelpers/Content/Random/GetViewHelper.php

@@ -0,0 +1,30 @@
+<?php
+namespace FluidTYPO3\Vhs\ViewHelpers\Content\Random;
+
+/*
+ * This file is part of the FluidTYPO3/Vhs project under GPLv2 or later.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.md file that was distributed with this source code.
+ */
+
+use FluidTYPO3\Vhs\ViewHelpers\Content\Random\RenderViewHelper;
+
+/**
+ * ViewHelper for fetching a random content element in Fluid page templates
+ *
+ * @author Björn Fromme, <fromme@dreipunktnull.com>, dreipunktnull
+ * @package Vhs
+ * @subpackage ViewHelpers\Content\Random
+ */
+class GetViewHelper extends RenderViewHelper {
+
+	/**
+	 * Initialize ViewHelper arguments
+	 */
+	public function initializeArguments() {
+		parent::initializeArguments();
+		$this->overrideArgument('render', 'boolean', 'Optional returning variable as original table rows', FALSE, FALSE);
+	}
+
+}

typo3conf/ext/vhs/Classes/ViewHelpers/Content/Random/RenderViewHelper.php

@@ -0,0 +1,58 @@
+<?php
+namespace FluidTYPO3\Vhs\ViewHelpers\Content\Random;
+
+/*
+ * This file is part of the FluidTYPO3/Vhs project under GPLv2 or later.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.md file that was distributed with this source code.
+ */
+
+use FluidTYPO3\Vhs\ViewHelpers\Content\AbstractContentViewHelper;
+
+/**
+ * ViewHelper for rendering a random content element in Fluid page templates
+ *
+ * @author Björn Fromme, <fromme@dreipunktnull.com>, dreipunktnull
+ * @package Vhs
+ * @subpackage ViewHelpers\Content\Random
+ */
+class RenderViewHelper extends AbstractContentViewHelper {
+
+	/**
+	 * Initialize ViewHelper arguments
+	 */
+	public function initializeArguments() {
+		parent::initializeArguments();
+		$this->overrideArgument('limit', 'integer', 'Optional limit to the number of content elements to render', FALSE, 1);
+	}
+
+	/**
+	 * Render method
+	 *
+	 * @return mixed
+	 */
+	public function render() {
+		if ('BE' === TYPO3_MODE) {
+			return '';
+		}
+ 		// Remove limit for getContentRecords()
+		$limit = $this->arguments['limit'];
+		$this->arguments['limit'] = NULL;
+		// Just using getContentRecords with a limit of 1 would not support
+		// using slideCollect as collecting would stop as soon as one record
+		// was found. As a potential optimization, $render could be overrided
+		// so all the content records that end up unused do not get rendered.
+		$contentRecords = $this->getContentRecords();
+		if (FALSE === empty($contentRecords)) {
+			shuffle($contentRecords);
+			$contentRecords = array_slice($contentRecords, 0, $limit);
+			if (TRUE === (boolean) $this->arguments['render']) {
+				$contentRecords = implode(LF, $contentRecords);
+			}
+		}
+		return $contentRecords;
+	}
+
+
+}