Функции модуля

Несмотря на большое количество функций, используемых для формирования блогов, всё, что требуется, можно настроить в шаблонах, которые автоматически распределяются системой при создании новых блогов. Ниже перечислены основные функции, которые могут понадобиться для расширения функциональности блогов:
 

nc_blog_show_blogs()

Функция вывода листинга блогов, устарела, вместо неё используется функция nc_blog_list().
 

nc_blog_list ( $sub, $template = "", $orderBy = "", $ignore_access = "" ) 

Функция возвращает форматированный список блогов из раздела $sub сколько блогов, сами блоги, ссылки на них, сколько сообщений и юзеров.

nc_blog_get_blogs($sub, $orderBy = "", $ignore_access="")

Функция возвращает массив с полными данными о разделе с блогами, сколько блогов, сами блоги, ссылки на них, сколько сообщений и юзеров. Используется как вспомогательная функция для функции nc_blog_list().

Возвращает массив, каждый элемент которого - блог в разделе $sub.
 

nc_blog_check_name ( $sub, $blogname )

Функция проверяет, свободно ли имя $blogname в разделе $sub. Если блог (раздел) с таким именем уже есть в этом разделе, функция возвратит его идентификатор.

Пример использования:

<?=(nc_blog_check_name(123, "techno") ? "такой блог уже существует" : "");?>

nc_blog_user_permission ( $sub, $cc )

Функция возвратит права данного пользователя на текущйй раздел или компонент. Формат возвращаемого значения – «u», «m», «a». Что соответственно означает – пользователь, модератор, администратор.
 

nc_blog_get_type ( $sub, $is_child=false ) 

Функция возвращает тип блога. $sub – идентификатор раздела. Если раздел является блогом, то вызов функции должен осуществляться с параметром $is_child=1. Если раздел $sub является корневой директорией для блогов (корнем блогов), то дополнительный параметр не требуется.

Пример использования: для корневой директории:

<?=($blog_type=nc_blog_get_type(45)?"":””);?>

Для блога пользователя, который находится в корневой директории:

<?=($blog_type=nc_blog_get_type(55, 1)?"":””);?>

nc_blog_get_creator ( $sub )

Функция возвращает создателя блога с идентификатором $sub. $sub – идентификатор раздела блога.

Пример использования:

<?=($blog_creator=nc_blog_get_creator(55)?"":””);?>

nc_blog_get_blogtype() 

Функция является устаревшим аналогом nc_blog_get_type(). В данный момент следует использовать новую функцию nc_blog_get_type().

nc_blog_visual_settings ( $sub, $VS_template_Header="", $VS_template_Object="", $VS_template_Footer="" ) 

Функция вывода визуальных настроек во front-office.

• $sub – идентификатор раздела, в котором осуществляется настройка;
• $VS_template_Header - шапка макета вывода;
• $VS_template_Object – объект в макете;
• $VS_template_Footer – футер макета вывода.

Последние 3 параметра отвечают за визуальное оформление настроек, в частности, в них можно передать таблицу, разделённую на три части. Предполагается вызов этой функции внутри формы добавления:

<form name='adminForm' enctype='multipart/form-data' method='post' action='/netcat/modules/blog/add.php'>
    <input name='sub' value='$sub' type='hidden'>
    <input name='cc' value='$cc' type='hidden'>
    <input name='nc_blog_operation' value='visual_settings' type='hidden'>
    <?=NC_Blog_Visual_Settings($sub, $VS_template_Header, $VS_template_Object, $VS_template_Footer);?>
    <input value='Сохранить' type='submit'>
</form>

nc_blog_is_friend ( $friendID ) 

Данная функция определяет, является ли пользователь с идентификатором $friendID другом текущего пользователя. Предполагается применение только для личных блогов.
 

nc_blog_bbcode() 

Функция в данный момент не используется, т.к. Её функционал входит в состав функции nc_bbcode().

nc_blog_cut() 

Функция в данный момент не используется, т.к. Её функционал входит в состав функции nc_bbcode().