Вывод случайного изображения из папки — различия между версиями

Материал из Umicms
Перейти к:навигация, поиск
(Новая страница: « category:Написание кастомных макросов <p> '''Задача''': </p> <p> Вывести случайное изображение из …»)
 
(Использование макроса в PHP)
 
(не показано 8 промежуточных версий 3 участников)
Строка 1: Строка 1:
 
  [[category:Написание кастомных макросов]]
 
  [[category:Написание кастомных макросов]]
<p>
+
[[category:Верстка в XSLT]]
'''Задача''':
+
[[category:Верстка в TPL]]
</p>
+
'''Актуально для версии 20'''
<p>
+
 
 +
== Задача ==
 +
 
 
Вывести случайное изображение из указанной папки.
 
Вывести случайное изображение из указанной папки.
</p>
+
 
<p>
+
== Решение ==
'''Решение''':
+
 
</p>
+
Для решения задачи будем использовать кастомный макрос. Назовём его, например - "getRandomImage". Код макроса нужно поместить в файл "/classes/components/custom.php".
<p>
 
Для решения задачи будем использовать кастомный макрос. Назовём его, например - "getRandomImage". Код макроса нужно поместить в файл "/classes/modules/custom.php".
 
</p>
 
<p style="text-align: right;">
 
'''Листинг 1. Код макроса'''
 
</p>
 
 
<source lang="php">
 
<source lang="php">
/*
+
public function getRandomImage($folder, $template = 'default') {
  @param String
+
if (!file_exists($folder)) {
    $folder - папка поиска изображений
+
return;
  @param String
+
}
    $template - шаблон вывода изображения в TPL
+
 
*/
+
$exts = ['gif', 'jpg', 'jpeg', 'png'];
public function getRandomImage($folder, $template = 'default') {
+
$images = [];
  if(!file_exists($folder))
+
$dh = opendir($folder);
    return;
+
while (($file = readdir($dh)) == true) {
 +
$fileExt = pathinfo($file, PATHINFO_EXTENSION);
 +
if (in_array($fileExt, $exts)) {
 +
$images[] = $file;
 +
}
 +
}
 +
 +
closedir($dh);
 +
 +
$fileName = null;
 +
$imagesCount = count($images);
 +
if ($imagesCount > 0) {
 +
$imageNumber = time() % $imagesCount;
 +
$fileName = $folder.$images[$imageNumber];
 +
}
 +
 +
if (!$template) {
 +
$template = 'default';
 +
}
 +
 +
list($image) = def_module::loadTemplates('random/'.$template, 'image');
 +
 +
$blockArr = [];
 +
$blockArr['filename'] = $fileName;
 +
 +
return def_module::parseTemplate($image, $blockArr);
 +
}
  
  $exts = array('gif', 'jpg', 'jpeg', 'png');
 
  $images = array();
 
  $dh = opendir($folder);
 
  while(($file = readdir($dh)) == true) {
 
    $fileInfo = pathinfo($file);
 
    $fileExt = $fileInfo['extension'];
 
    if(in_array($fileExt, $exts))
 
      $images[] = $file;
 
  }
 
 
 
  closedir($dh);
 
 
 
  $fileName = null;
 
  $imagesCount = count($images);
 
  if($imagesCount > 0) {
 
    $imageNumber = time() % $imagesCount;
 
    $fileName = $folder.$images[$imageNumber];
 
  }
 
 
 
  if(!$template)
 
    $template = 'default';
 
   
 
  list($image) =
 
    def_module::loadTemplates('random/'.$template, 'image');
 
   
 
  $blockArr = array();
 
  $blockArr['filename'] = $fileName;
 
 
 
  return def_module::parseTemplate($image, $blockArr);
 
}
 
 
</source>
 
</source>
<p>
+
 
Макрос принимает два параметра: папку с изображениями и шаблон вывода. В XSLT шаблон вывода не используется. Если же Вы используете TPL, то необходимо создать файл "tpls/random/default.tpl" (это будет шаблон вывода по умолчанию, если не будет указан другой) со следующим содержанием:
+
Макрос принимает два параметра: папку с изображениями и шаблон вывода. В XSLT шаблон вывода не используется.  
</p>
+
 
<p style="text-align: right;">
+
Если же Вы используете TPL, то необходимо создать файл "tpls/random/default.tpl" (это будет шаблон вывода по умолчанию, если не будет указан другой) со следующим содержанием:
'''Листинг 2. Шаблон вывода'''
+
 
</p>
 
 
<source lang="php">
 
<source lang="php">
 
<?php
 
<?php
Строка 76: Строка 67:
 
?>
 
?>
 
</source>
 
</source>
<p>
+
 
Примеры использования макроса в TPL и XSLT:
+
=== Использование макроса в TPL ===
</p>
+
 
<p style="text-align: right;">
 
'''Листинг 3. Использование макроса в TPL'''
 
</p>
 
 
<source lang="php">
 
<source lang="php">
 
%custom getRandomImage('/images/')%
 
%custom getRandomImage('/images/')%
 
</source>
 
</source>
<p style="text-align: right;">
 
'''Листинг 4. Использование макроса в XSLT'''
 
</p>
 
<source lang="html4strict>
 
<xsl:apply-templates select="document('udata://photoalbum/getRandomImage/(./images/cms)/')/udata" />
 
  
<xsl:template match="udata[@module = 'photoalbum'][@method = 'getRandomImage']">
+
=== Использование макроса в XSLT ===
  <xsl:variable name="img" select="filename" />
+
 
  <img src="{$img}" alt="random image" border="0" />
+
<source lang="html4strict">
 +
<xsl:apply-templates select="document('udata://custom/getRandomImage/(./images/cms)/')/udata" />
 +
 
 +
<xsl:template match="udata[@module = 'custom'][@method = 'getRandomImage']">
 +
<xsl:variable name="img" select="filename" />
 +
<img src="{$img}" alt="random image" border="0" />
 
</xsl:template>
 
</xsl:template>
 +
</source>
 +
 +
=== Использование макроса в PHP ===
 +
 +
<source lang="php">
 +
<?php
 +
$imageData = $this->macros('custom', 'getRandomImage', ['./images/']);
 +
?>
 +
<img src="<?=$imageData['filename']?>" alt="random image" border="0">
 
</source>
 
</source>

Текущая версия на 10:48, 31 октября 2019

Актуально для версии 20

Задача

Вывести случайное изображение из указанной папки.

Решение

Для решения задачи будем использовать кастомный макрос. Назовём его, например - "getRandomImage". Код макроса нужно поместить в файл "/classes/components/custom.php".

	public function getRandomImage($folder, $template = 'default') {
		if (!file_exists($folder)) {
			return;
		}

		$exts = ['gif', 'jpg', 'jpeg', 'png'];
		$images = [];
		$dh = opendir($folder);
		while (($file = readdir($dh)) == true) {
			$fileExt = pathinfo($file, PATHINFO_EXTENSION);
			if (in_array($fileExt, $exts)) {
				$images[] = $file;
			}
		}
		
		closedir($dh);
		
		$fileName = null;
		$imagesCount = count($images);
		if ($imagesCount > 0) {
			$imageNumber = time() % $imagesCount;
			$fileName = $folder.$images[$imageNumber];
		}
		
		if (!$template) {
			$template = 'default';
		}
		
		list($image) = def_module::loadTemplates('random/'.$template, 'image');
		
		$blockArr = [];
		$blockArr['filename'] = $fileName;
		
		return def_module::parseTemplate($image, $blockArr);
	}

Макрос принимает два параметра: папку с изображениями и шаблон вывода. В XSLT шаблон вывода не используется.

Если же Вы используете TPL, то необходимо создать файл "tpls/random/default.tpl" (это будет шаблон вывода по умолчанию, если не будет указан другой) со следующим содержанием:

<?php
 
$FORMS = Array();
 
$FORMS['image'] = <<<END
 
<img src="%filename%" alt="random image" border="0" />
 
END;
 
?>

Использование макроса в TPL

%custom getRandomImage('/images/')%

Использование макроса в XSLT

<xsl:apply-templates select="document('udata://custom/getRandomImage/(./images/cms)/')/udata" />

<xsl:template match="udata[@module = 'custom'][@method = 'getRandomImage']">
	<xsl:variable name="img" select="filename" />
	<img src="{$img}" alt="random image" border="0" />
</xsl:template>

Использование макроса в PHP

<?php 
	$imageData = $this->macros('custom', 'getRandomImage', ['./images/']);
?>
<img src="<?=$imageData['filename']?>" alt="random image" border="0">