View file library/wap-motor/library.txt

File size: 8.06Kb
Учимся работать с библиотекой
Итат, эта статья предназначена для тех кто хочет понять как правильно работать с новой библиотекой от WAP-MOTOR 16.2
Структура библиотеки двухуровневая, в возможностях работа только с 1 уровнем подпапок
Для начала нам нужно создать новый раздел (Папку)
Для этого достаточно всего лишь создать новую папку в категории library, сделать это можно к примеру по FTP,
далее для того, чтобы папка  имела название создаем в ней файл name.dat, вписываем туда строку с названием и сохраняем в кодировке UTF-8 (Вся работа осуществляется только с этой кодировкой)
Эта строка и будет служить нам названием папки.
	
Если у вас не отображается название раздела, то возможно несколько причин, вы неправильно назвали имя файла, (name.dat) или не вписали туда строку с названием, строка может быть и на русском языке
Далее как закидывать статьи в библиотеку, делать это можно также по FTP, после того как вы положили файл (Статью) в нужную вам папку (Раздел), она автоматически будет отображена скриптом, все статьи должны быть строго с расширение .txt, название файла может быть любое из латинских букв, цифр, знака тире и нижнего подчеркивания (A-Z a-z 0-9 _-)
Название статьи генерируется из первой строчки файла, то есть для того, чтобы название статьи было на русском языке, достаточно в первой строке написать к примеру "Али баба и 40 разбойников" после этого необходимо сделать перевод строки, иначе название будет продолжено
А само название файла может быть любым, к примеру 1.txt, 2.txt, 3.txt и т.д. это не повлияет на вывод названий
	
К примеру структура такова:
	
Кое-что о WAP (Здесь перевод строки)
Сегодня и в России уже никого не удивишь сотовым телефоном. Трубки есть и у бизнесменов, и у студентов. Однако если последние используют возможности трубки процентов на 50 - 60, а может - и меньше, то деловые люди, как говорится, берут от телефона все. Или почти все. 

Вот название которое будет отображено: Кое-что о WAP
	
Далее рассмотрим как скрипт разбивает текст по страницам
Админ сайта может в настройках сайта  Админка->Настройки системы->Библиотека изменить вывод количества строк и статей на страницу
Вот именно по количеству строк и разбиваются статьи на страницы, 
	
К примеру:

1 строка 
2 строка
	
4 строка и тд, 

Двойной перевод строки считается как 2 строки, чем больше строк тем больше страниц у статьи
Ошибкой будет писать все в одну строку, вохможно в вашем текстовом редакторе стоит автоматический перевод строки, и к примеру статья всего в 1 строку, может быть разбита автоматически и выглядить как 10 строк, но на самом деле будет всего 1 строка
	
Вывод новых статей на главную страницу
После того как вы добавили ссылку на главную (main.php)
echo'<img src="images/img/act2.gif" alt=""> <a href="library/?'.SID.'">Библиотека</a>'; include_once"template/library.php";
Рядом с названием "Библиотека" Будет отображено общее число статей (14)
При добавлении новых статей в библиотеку, они не сразу будут посчитаны и отображены
Срабатывает функция кеширования общего количества файлов во всех папках, так как при большом количестве статей подсчет занимает какое-то более продолжительное время, а частое обновления страницы, могут вызвать нагрузку на сервер, было решено кешировать все результаты, 
Раз в час происходит подсчет и данные записываются в файл,  новые файлы будут посчитаны не сразу, а через некоторое время,
Время кеширования вы можете отрегулировать сами, для этого открываем файл template/library.php
Находим строку 
$filtime=$filtime+3600; //1-часовое индексирование
Изменяем данные на свои к примеру
$filtime=$filtime+(3600*3); //Будет уже как 3-часовое индексирование, а если убрать эту строку или закомметировать
//$filtime=$filtime+3600; //1-часовое индексирование,
то данные будут считаться при каждом обновлении страницы
	
Текст библиотеки полностью обрабатывается, вы можете не переживать за какие-то знаки или php-код, также это означает что и теги будут обработаны, возможно в дополнениях будет возможность вставки некоторых самых основных тегов, но это в будущем	
	
Также в этой библиотеке применена новая система антифлуда, более улучшенная и совершенная, подробнее о всех преимуществах вы узнаете при выходе новой версии движка
Еще одно из новшеств, вывод графической картинки вместо среднего количества оценки теперь выводится картинка учитывая среднее число оценок подставляется соответствующая картинка рейтинга
Работать теперь с библиотекой стало и удобнее и приятнее, надеемся вы в полной мере оцените все изменения и улучшения новой библиотеки
Обо всех замеченых ошибках кода, просьба сообщать разработчикам проекта

Автор статьи: (Григорьев Александр Владимирович) Вантуз (http://pizdec.ru)