Настраиваем облако тегов в WordPress с помощью wp_tag_cloud(). Виджет «Облако меток» на WordPress Wp облако

В этом посте мы разберем плагин WP-Cumulus который выводит метки (теги) в виде подвижной объемной сферы (flash ).Облако тегов удобно тем, что посетителю не нужно будет искать интересные ему статьи по всем рубрикам, а просто воспользоваться тегами.

Установка плагина и настройка

1. Ваша версия WordPress должна быть 2.3 или выше. Облако тегов для W ordpress не будет работать с более старыми версиями.

2. Качаем русскую версию Кидаем папку wp-cumulus в ваш каталог плагинов (wp-content/plugins/ ).

3.Активируем плагин в админке.

Все настройки плагина находятся в (Парамет рах\WP Cumulus) . Если вдруг у вас в настройках плагина не стоит галочка, (Расположить теги равномерно на сфере ) то нужно обязательно поставить. А то иначе теги в облаке будут друг на друга наезжать и будет не красиво.

Чтобы вывести wordpress облако тегов, у вас есть три варианта.

1. Если вам нужно вставить wordpress облако в статью или в страницу, добавьте в нее тег

Этот тег будет заменен на flash облако тегов при просмотре страницы.

2. Для вставки wordpress облака тегов через шаблон используем код:

3. Если вы хотите вывести облако тегов в сайдбаре.То вам нужно зайти в (Дизайн\Виджеты ) и добавить виджет.

Виджет имеет отдельный набор настроек, так что можем изменить цвет фона, размеров и т.п.

Настройте этот виджет так, как вам нужно и нажмите на "Сохранить ".

Все переведено на русский, думаю разберетесь.

В сем привет. Сегодня мы с вами будем красиво оформлять при помощи стилей оформления CSS3 метки (облако тегов). Метки - используются на сайтах для группировки записей по какому-то признаку и предназначены для удобства нахождения информации пользователем на блоге. Для вывода всех меток в WordPress используется виджет: облако меток.

Облако тегов в wordpress

Для отображения облака тегов на сайте достаточно просто перетащить виджет в нужное место сайдбара или (см. скриншот). Но, если вы в процессе написания записей не указывали метки для записи, то это облако тегов будет у вас пустым. Практически все бесплатные cms для создания сайтов, имеют встроенную поддержку меток, их можно создавать при написании записи или после в админ панели сайта, раздел «Записи» - «Метки».

После добавления облака тегов на сайт, они будут иметь не очень красивый вид, а мы с вами попытаемся сделать их более привлекательными:

Ну что, подойдет такое оформление? Тогда приступим.

Файл стилей облака тегов wordpress

Для создания такого облака тегов мы с вами будем использовать стилевое оформление на CSS3:

Tags { float: left; margin: 0 0 7px 15px; position: relative;

font-family: ‘Helvetica Neue’, Helvetica, Arial, sans-serif; font-size: 0.75em; font-weight: bold; text-decoration: none; color: #996633; text-shadow: 0px 1px 0px rgba(255,255,255,.4); padding: 0em 0.417em 0.05em 0.917em; border-top: 1px solid #d99d38; border-right: 1px solid #d99d38; border-bottom: 1px solid #d99d38; -webkit-border-radius: 0 0.25em 0.25em 0; -moz-border-radius: 0 0.25em 0.25em 0; border-radius: 0 0.25em 0.25em 0; background-image: -webkit-linear-gradient(top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: -moz-linear-gradient(top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: -o-linear-gradient(top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: -ms-linear-gradient(top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: linear-gradient(top, rgb(254, 218, 113), rgb(254, 186, 71)); filter: progid: DXImageTransform.Microsoft.gradient(GradientType=0,StartColorStr=’#feda71′, EndColorStr=’#feba47′); -webkit-box-shadow: inset 0 1px 0 #faeaba, 0 1px 1px rgba(0,0,0,.1); -moz-box-shadow: inset 0 1px 0 #faeaba, 0 1px 1px rgba(0,0,0,.1); box-shadow: inset 0 1px 0 #faeaba, 0 1px 1px rgba(0,0,0,.1); } .tags:before { content:»; width: 1.30em; height: 1.358em; background-image: -webkit-linear-gradient(left top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: -moz-linear-gradient(left top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: -o-linear-gradient(left top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: -ms-linear-gradient(left top, rgb(254, 218, 113), rgb(254, 186, 71)); background-image: linear-gradient(left top, rgb(254, 218, 113), rgb(254, 186, 71)); filter: progid:DXImageTransform.Microsoft.gradient(GradientType=1,StartColorStr=’#feda71′, EndColorStr=’#feba47′); position: absolute; left: -0.69em; top: .2em; -webkit-transform: rotate(45deg); -moz-transform: rotate(45deg); -o-transform: rotate(45deg); transform: rotate(45deg); border-left: 1px solid #d99d38; border-bottom: 1px solid #d99d38; -webkit-border-radius: 0 0 0 0.25em; -moz-border-radius: 0 0 0 0.25em; border-radius: 0 0 0 0.25em; z-index: 1; } .tags: after { content:»; width: 0.5em; height: 0.5em; background: #fff; -webkit-border-radius: 4.167em; -moz-border-radius: 4.167em; border-radius: 4.167em; border: 1px solid #d99d38; -webkit-box-shadow: 0 1px 0 #faeaba; -moz-box-shadow: 0 1px 0 #faeaba; box-shadow: 0 1px 0 #faeaba; position: absolute; top: 0.667em; left: -0.083em; z-index: 9999; } .tags: hover { background-image: -webkit-linear-gradient(top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: -moz-linear-gradient(top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: -o-linear-gradient(top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: -ms-linear-gradient(top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: linear-gradient(top, rgb(254, 225, 141), rgb(254, 200, 108)); filter: progid: DXImageTransform.Microsoft.gradient(GradientType=0,StartColorStr=’#fee18d’, EndColorStr=’#fec86c’); border-color: #e1b160; } .tags: hover: before { background-image: -webkit-linear-gradient(left top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: -moz-linear-gradient(left top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: -o-linear-gradient(left top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: -ms-linear-gradient(left top, rgb(254, 225, 141), rgb(254, 200, 108)); background-image: linear-gradient(left top, rgb(254, 225, 141), rgb(254, 200, 108)); filter: progid: DXImageTransform.Microsoft.gradient(GradientType=1,StartColorStr=’#fee18d’, EndColorStr=’#fec86c’);

border-color: #e1b160; }

Откройте админ панель сайта и перейдите на вкладку внешний вид/редактор, в правой колонке выберете файл style.css Скопируйте приведенный выше код и вставьте его в самый конец файла. На этом работа с файлом стилей завершена.

Параметры облака тегов - функция wp_tag_cloud

Если, открыть Html код страницы, и посмотреть на отображение облака тегов , то можно увидеть, что оно описывается двумя классами:

  • tagcloud
  • tags-link

Первым классом tagcloud описывается размер шрифта, формат вывода ссылок, порядок сортировки, разделитель между тегами, и.т.п Вторым классом tags-link описываются непосредственно теги.

Чтобы внести изменения в эти классы нам нужно открыть файл функций (function.php). И добавить в конец файла код описывающий класс tagcloud :

Function set_tag_cloud_args($args) { $args["number"] = 30; $args["largest"] = 10; $args["smallest"] = 10; $args["unit"] = "px"; $args["format"] = "flat"; return $args; }

  • smallest – минимальный размер шрифта наименее популярных тегов;
  • largest – максимальный размер шрифта для популярных меток;
  • unit – величина для определения шрифта – pt, px, em, % (по умолчанию в pt, я ставлю обычно в пикселях px);
  • number – количество тегов для отображения (45 по умолчанию);
  • format – формат вывода ссылок: flat (разделенные пробелом – по умолчанию), list – список UL, array – как массив для PHP;
  • separator – разделитель между тегами (по умолчанию – пробел);
  • orderby – сортировка: name – по названию (изначально), count – по популярности;
  • order – порядок сортировки: возрастающая – ASC (изначально), по спадающей – DESC, случайным образом – RAND;
  • exclude – теги для исключения из облака;
  • include – теги для включения в облако (будут отображены только они).

Обязательно установите параметр ‘largest’=’smallest’ = 10; - одинаковый размер шрифта для популярных и наименее популярных меток облака тегов . Остальные параметры устанавливайте на ваше усмотрение.

Теперь в файле category-template.php (он находится в папке wp-includes), найдите при помощи сочетания клавиш cntr+F следующие строки:

$a = "$tag_name";

$a = "$tag_name";

Хотите расположить свои метки на облаке, вернее, на динамическом облаке, которое всегда в движении и привлекает внимание посетителей сайта? Думаю, что да, потому что сегодня получила несколько писем с вопросом: на блог. А если есть такие, кто еще не знает нужно это ему или нет, или вообще не знают о чем речь, то просто посмотрите на главную страницу моего блога и оцените, как Вам облако меток WordPress.

Давайте перейдем к делу: чтобы установить облако меток WordPress нужно установить и активировать плагин WP Cumulus. При этом обратите ВНИМАНИЕ, что этот плагин нужно обязательно скачать самостоятельно с Интернет! Обязательно русскоязычную версию!! А то, если воспользоваться поиском при на вкладке Добавить плагин, поиск найдет англоязычный вариант этого плагина, который не сможет корректно работать с Вашими русскими тегами.

  1. ПУА - Плагин - Добавить плагин - Загрузить файл.
  2. Активировать.
  3. Настроить плагин.

Что значит настроить плагин? А давайте не будем настраивать и просто посмотрим как выглядит наше облако на странице!

Чтобы добавить облако на страницу, выберите Виджет Облако меток и перетащите его в сайдбар. Готово? Тогда переходите к просмотру главной страницы сайта.

И как? Все нравится?

  • Цвет текста, цвет фона устраивает?
  • Проверьте работу тегов: нажмите на любой тег и посмотрите результат. Кстати, успели нажать на тег? Скорость вращения устраивает?
  • Кстати, обратите внимание, вписалось ли Ваше облако в размеры сайд-бара! У меня при первоначальной установке размеры облака не соответствовали моему сайд-бару.
  • Как расположены ваши теги? Не кажется Вам, что они сбились в кучку? Если, да, то обязательно нужно поставить галочку в настройках плагина, чтобы равномерно расположить теги на облаке.

Поэтому, все-таки, давайте вернемся на страницу настройки облака и подправим все, что нас не устраивает.

Для настройки плагина смело нажимайте ЛКМ на названии плагина WP Cumulus на вкладке Настройка. Вносите необходимые Вам изменения, переходите на сайт и любуйтесь изменениями. Только ВНИМАНИЕ, сделав изменения, обязательно проверьте как это выглядит в реалии, и если что возвращайте параметры на место.

Кстати, эти же настройки плагина можно выполнить, если нажмете Облако меток на вкладке Виджеты.

НЕ ЗАБУДЬТЕ! Обращаю Ваше внимание, что нужно обязательно поставить галочку

Располагает теги на равных друг от друга расстояниях вместо случайного расположения

иначе Ваши теги могут сбиваться в кучку и удовольствия и красоты от облака Вы не получите!

Кстати, чуть не забыла предупредить: плагин нужно устанавливать только, если есть хотя бы одна метка!!! Если меток нет, обязательно открывайте статьи и добавляйте метки!!!

Подведем итоги:

  • узнали зачем нужен плагин WP Cumulus
  • скачали плагин WP Cumulus
  • узнали, как установить, активировать, настроить плагин WP Cumulus
  • узнали, как установить облако меток WordPress на блог

Я тестировала работу этого облака три месяца и решила, что пока уберу это облако со своего сайта. Протестирую работу блога без облака меток.

Выводит или получает облако меток (список меток в виде облака). Можно указать произвольную таксономию.

Чтобы вывести элементы произвольной таксономии в виде облака, укажите название таксономии в параметре taxonomy .

"Облако меток" называется так, потому что размер текста каждой метки зависит от того, сколько записей связано с меткой. Чем больше записей, тем больше будет текст метки (в итоге получается нечто похожее на облако).

С версии 2.8 был добавлен параметр taxonomy , позволяющий создавать облако не только для стандартных меток, но и для категорий и произвольных таксономий.

Возвращает

null. Выводит на экран html код списка.

  • Возвращает HTML, если параметр echo = false .
  • Вернет массив облака меток, если параметр format = array .
  • false, если не удалось получить метки.

Шаблон использования

wp_tag_cloud(array("smallest" => 8, "largest" => 22, "unit" => "pt", "number" => 45, "format" => "flat", "separator" => "\n", "orderby" => "name", "order" => "ASC", "exclude" => null, "include" => null, "link" => "view", "taxonomy" => "post_tag", "echo" => true, "topic_count_text_callback" => "default_topic_count_text",));

Использование

$args(строка/массив) Аргументы, на основе которых будет построен список.
По умолчанию: базовые значения

Аргументы параметра $args

В $args можно также указать все параметры функции get_terms() . Получение элементов таксономии работает на базе этой функции.

Smallest(число) Размер текста для меток с меньшим
По умолчанию: 8 largest(число) Размер текста для меток с большим количеством записей (единицы измерения указываются в параметре unit).
По умолчанию: unit(строка) Единицы измерения параметров smallest и largest . Может быть любым CSS типом размера: pt , px , em , % .
По умолчанию: "pt" number(число) Максимально количество меток, которое будет показано в списке. Если установить на 0 , то будут показаны все метки без ограничения.
По умолчанию: 45 format(строка)

В каком формате выводить список. Может быть:

  • flat - метки будут разделены разделителем, указанным в параметре separator ;
  • list - UL список с CSS классом "wp-tag-cloud";
  • array - вернет облако меток в массиве для дальнейшей обработки в PHP.
    По умолчанию: "flat"
separator(строка) Текст между метками.
По умолчанию: "\n" orderby(строка) Сортировать метки по имени (name) или количеству записей (count). Не влияет на запрос к базе данных.
По умолчанию: "name" order(строка)

Порядок сортировки. Может быть:

  • ASC - по порядку (1,2,3);
  • DESC - в обратном порядке (3,2,1);
  • RAND - хаотичный порядок (перемешать).

order и orderby не влияют на запрос к базе данных. Метки сначала получаются из базы данных, затем сортируются. Эти параметры для получения из базы данных равны: orderby=count и order=DESC и их нельзя изменить.
По умолчанию: "ASC"

Exclude(строка) Исключить указанные метки. Указывать нужно ID через запятую.
По умолчанию: null include(строка) Показать только указанные метки. Указывать нужно ID через запятую.
По умолчанию: null topic_count_text_callback(строка/массив) Функция, которая получает количество записей и возвращает текст для метки. Можно установить свою функцию, если нужно отображать какой-либо другой текст с количеством записей для каждой метки.
По умолчанию: default_topic_count_text link(строка)

  • view - по нажатию на метку, попадем на страницу метки;
  • edit - по нажатию на метку, попадем на страницу редактирования метки.
    По умолчанию: view
taxonomy(строка/массив)

Название таксономии или массив нескольких названий, из которых будет построено облако. Может быть:

  • post_tag ;
  • category ;
  • link_category ;
  • Своя таксономия;
  • Массив названий таксономий - параметр введен в версии 3.1.
    По умолчанию: post_tag
show_count(логический) Показывать ли число записей в метке. По умолчанию 0. Может быть: 0, 1 или true/false. С WP 4.8. echo(логический) 1 - Выводить на экран, 0 - возвращать результат для дальнейшей обработки.
По умолчанию: 1 (true)

Примеры

#1 Базовое использование

Выведем облако меток с заголовком "Популярные метки":

Популярные метки"; wp_tag_cloud("smallest=8&largest=22"); } ?>

#1.2. Еще одни пример демонстрирующий передачу разных параметров

Изменим размеры меток (smallest=15&largest=40), ограничим количество выводимых меток (number=50) и отсортируем их по количеству записей, а не по имени (orderby=count):

#2 Получим список, не будем выводить его на экран

Запишем список в параметр $tag, чтобы потом использовать его в php для своих целей:

#3 Облако категорий

"category")); ?>

#3.1. Облако меток и категорий одновременно

array("post_tag","category"),)); ?>

#4 Изменение текста атрибута title у тега

"my_tag_text_callback")); function my_tag_text_callback($count) { return sprintf(_n("%s картинка", "%s картинок", $count), number_format_i18n($count)); } ?>

#5 Архив меток

Как один из вариантов использования меток, предлагаю создать архивные страницы меток. При клике на определенную метку, мы попадаем на страницу с постами связанными с этой меткой. Как выглядет такая страница, определяется файлом шаблона tag.php , если такого файла нет (обычно его ент), то формирование вывода отдается файлу archives.php .

Давайте сделаем страницу метки, на которой в самом начале будет показано облако меток, а после него записи относящиеся к выбранной метке. Для этого создадим (если нет) или изменим (если существует) файл tag.php. Создавать файл нужно в каталоге темы.

Содержимое файла tags.php:

Tag Archive

" rel="bookmark" title="Permanent Link to ">

В данном примере не учитываются CSS стили, поэтому возможна несовместимость с шаблоном.

#6 Изменение параметров по умолчанию для виджета облака меток через фильтр

Допустим, нам нужно уменьшить максимальный шрифты для виджета с облаком меток. Нужно поставить значение 16, а не 22 для параметра "largest". Для этого используем хук widget_tag_cloud_args

Add_filter("widget_tag_cloud_args", function($args){ $args["largest"] = 16; return $args; });

На этот пример меня подтолкнул этот комменатрий

Заметки

  • В версии 3.1 добавлен возможность передавать массивы в параметр taxonomy ;
  • В версии 2.9 добавлен параметр separator ;
  • В версии 2.8 добавлены параметры taxonomy и echo ;
  • В версии 2.7 добавлен параметр link ;

Код wp tag cloud : wp-includes/category-template.php WP 5.2.2

8, "largest" => 22, "unit" => "pt", "number" => 45, "format" => "flat", "separator" => "\n", "orderby" => "name", "order" => "ASC", "exclude" => "", "include" => "", "link" => "view", "taxonomy" => "post_tag", "post_type" => "", "echo" => true, "show_count" => 0,); $args = wp_parse_args($args, $defaults); $tags = get_terms($args["taxonomy"], array_merge($args, array("orderby" => "count", "order" => "DESC",))); // Always query top tags if (empty($tags) || is_wp_error($tags)) { return; } foreach ($tags as $key => $tag) { if ("edit" == $args["link"]) { $link = get_edit_term_link($tag->term_id, $tag->taxonomy, $args["post_type"]); } else { $link = get_term_link(intval($tag->term_id), $tag->taxonomy); } if (is_wp_error($link)) { return; } $tags[ $key ]->link = $link; $tags[ $key ]->id = $tag->term_id; } $return = wp_generate_tag_cloud($tags, $args); // Here"s where those top tags get sorted according to $args /** * Filters the tag cloud output. * * @since 2.3.0 * * @param string $return HTML output of the tag cloud. * @param array $args An array of tag cloud arguments. */ $return = apply_filters("wp_tag_cloud", $return, $args); if ("array" == $args["format"] || empty($args["echo"])) { return $return; } echo $return; }

WP-Cumulus: 3D облако меток на flash (улучшенная русская версия). Плагин WP-Cumulus уже старый и многие о нем слышали, а еще больше видели. Он предоставляет возможность выводить облако меток в виде вращающегося 3D облака, очень красиво. Его работу вы должны видеть выше. Автор плагина Roy Tanck.

Скачать

Поддержка версий: WP 2.8+

Скриншоты

Настройки

Настройки все описаны в плагине и на скриншотах и вопросов по ним возникнуть не должно. Кроме, пожалуй, опции Параметры функции wp_tag_cloud . В ней можно указать, как и какие ссылки будут показываться в облаке. Например, " number=20&exclude=12 " выведет только 20 меток, даже если их больше и исключит метку 12 (ID метки).

Все возможные параметры для этого параметра:

  • smallest - размер текста для меток с меньшим количеством записей. По умолчанию 8.
  • largest - размер текста для меток с большим количеством записей. По умолчанию 22.
  • unit - единица измерения размера для smallest и largest. Может быть:pt, px, em, %. По умолчанию pt.
  • number - максимально количество меток, которое будет показано. Если установить на 0, то будут показаны все метки без ограничения. По умолчанию 45.
  • exclude - исключить указанные метки. Указывать нужно ID через запятую.
  • include - показать только указанные метки. Указывать нужно ID через запятую.
  • taxonomy - название таксономии, из терминов которой будет построено облако. Благодаря этому параметру, можно вывести термины из любой таксономии, не только метки или категории.

Параметры объединяются знаком &: number=20&exclude=12 .

Вывод 3D облака в шаблоне

Если вам нужно вывести облако wp-cumulus прямо в шаблона, без использования виджета или шоткода, то в коде шаблона можно использовать функцию wp_cumulus_insert($options, $links) . Вывод можно настроить передав нужные параметр. Настройки из админ-панели будут перебиваться этими параметрами.

Параметры, которые можно передать:

$options = array("width" => "550", // ширина flash "height" => "375", // высота flash "tcolor" => "ffffff", // цвет больших ссылок "tcolor2" => "ffffff", // цвет маленьких ссылок "hicolor" => "ffffff", // цвет наведенной ссылки "bgcolor" => "333333", // цвет фона "speed" => "150", // скорость вращения "trans" => "false", // прозрачный фон у flash "args" => "", // аргументы передаваемые функции wp_tag_cloud. Пр.: largest=20&smallest=12&number=40 "mode" => "tags", // какие ссылки выводить: tags (метки), cats (категории), both (метки и категории) "compmode" => "js", // код вставки flash: js (javascript), пусто (object) "showwptags" => 1, // показывать ли HTML ссылки, если в браузере не работает flash); wp_cumulus_insert($options);

Примеры вывода 3D облака в шаблоне

#1 Выведем флэш блок меток с белым фоном, размером 300х225 пикселей.

Для этого откроем файл темы, например, sidebar.php и в нужное место вставим следующий код:

"300", "height"=>"225", "bgcolor"=>"ffffff")); ?>

#2 Выведем облако из 20 терминов произвольной таксономии "authors", укажем скорость вращения 300:

"taxonomy=authors&number20", "speed"=>"300")); ?>

#3 Выводим любые ссылки

Кроме терминов таксономий, в облаке можно выводить любые ссылки. Этот пример показывает как вывести постоянные страницы, для этого укажем второй аргумент функции $links:

-1, "post_type" => "page",)); // создаем строку ссылок $links = ""; foreach($posts as $post){ $fsize = rand(12,28); $links .= "ID) ."">". $post->post_title .""; } wp_reset_postdata(); // выводим wp_cumulus_insert("", $links); ?>

3D Облако без плагина

Если не хотите подключать плагин, то облако можно вывести без установки плагина. Для этого:

    Скачайте этот архив и разместите папку из него (wp-cumulus-not-plugin) в любой каталог, пусть это будет каталог темы;

  1. В том месте шаблона, где нужно вывести облако подключите файл wp-cumulus.php и используйте функцию wp_cumulus_theme_flashcode($options, $links) .
"600", // ширина flash "height" => "450", // высота flash "tcolor" => "3D3644", // цвет больших ссылок "tcolor2" => "7E748C", // цвет маленьких ссылок "hicolor" => "DE1E1C", // цвет наведенной ссылки "bgcolor" => "ffffff", // цвет фона "speed" => "300", // скорость вращения "mode" => "tags", // отображать метки (tags), категории (cats) или и то и другое (both) "args" => "largest=16&smallest=10&number=30", // аргументы передаваемые функции wp_tag_cloud //"folder_url" => get_stylesheet_directory_uri() . "/wp-cumulus-not-plugin/" // УРЛ до папки файла php)); ?>
Не работает?

Функция wp_cumulus_theme_flashcode() при выводе флеш объекта подключает 2 файла: swfobject.js и tagcloud.swf . УРЛ этих файлов функция определяет автоматически (они должны лежать в том же каталоге что и файл wp-cumulus.php). Если УРЛ определился неправильно, то облако может не работать. Поэтому при вызове функции, возможно, нужно будет указать параметр folder_url , в котором указать УРЛ до папки где лежат эти 2 файла.