Мультилист - это новая AJAX разработка, которая позволит вам сделать вывод данных намного удобнее и функциональнее.
Главной особеностью является возможность широкой кастомизации мультилиста под определенный тип вывода данных.
Вы можете выводить данные постранично сразу из нескольких таблиц, которые могут находится как в одной БД,
так и в нескольких. Немаловажным является и ajax работа данного мультилиста: любые новые записи, добавленные в таблицу(-ы),
будут немеделенно отображены в мультилисте без перезагрузки страницы! Есть наличие ajax поиска. Мультилист отлично оптимизирован.
Например, из данного мультилиста в пределах настройки конфига можно сделать банлист, топлист(топ голосующих, топ богачей, топ играющих, ...), вывод игроков проекта и многое многое другое.
Как установить и настроить?
Часть 1. Общая настройка мультилиста
1. Скачайте мультилист, откройте архив, выберите папку с нужной кодировкой и откройте её. Далее переместите появившуюся папку 'multilist' в любое место вашего сайта через FTP протокол. После этого откройте multilist/config.php уже на сайте.
2. В блоке СЕРВЕРЫ укажите данные доступа к вашей базе данных. Если у вас несколько серверов и, следовательно, несколько БД, то добавьте через запятую новые серверы, указав им данные от другой БД. Если несколько серверов принадлежат одной БД, то нет необходимости указывать одни и те же данные: замените host, name, user... одним параметром ''link' => [Порядковый номер сервера],'(Как пример, посмотрите внизу)
3. Настройте остальные блоки, такие как ШАБЛОН, ВЫВОД, ПОСТРАНИЧНАЯ НАВИГАЦИЯ, кроме блока ТАБЛИЦА. К нему мы вернемся.
Часть 2. Настройка столбцов будущего мультилиста
Перед тем, как начать настройку, вы должны четко представлять, каким должен быть мультилист по структуре. Если вы решили сделать банлист, то вам необходимо правильно(как по вашему) организовать последовательность колонок и определить тип вывода данных в каждой колонке: если это никнейм, то можно вывести его как ссылку на профиль данного пользователя, а саму колонку разместить в начале. Например, правильная структура банлиста такова:
Сервер | Игрок | Забанил | Причина | Бан получен | Разбан
Если это топ богачей, то возможна след. структура: Место | Игрок | Денег. При этом в первом случае колонки Бан получен и Разбан нужно выводить как дату(DD.MM.YYYY HH:MI:SS), а не в голом виде UNIX(типа 1440635142), а во втором случае колонку Денег следует выводить как n рубл[ь,я,ей], то есть например: 1 рубль, 103 рубля, 5113 рублей.
Как только вы полностью определились со структурой, можно приступать непосредственно к настройке.
1. В блоке Колонки блока ТАБЛИЦА перечислены всевозможные колонки, которые будут выводиться в мультилисте. Их общий вид следующий: array(Колонка в БД, Название, Сортировка, Поиск, Тип отображения, Ширина столбца), где первые 5 параметров обязательны для заполнения. Данные колонки можно удалить или добавить новые через запятую. Такие параметры как Сортировка, Поиск требуют установки только true или false. Параметр Тип отображения необходим для установки соответствующего режима вывода. Внизу для справки(см. в конфиге) перечислены все возможные типы отображения: as_name(никнейм), as_time(вывод прошлой даты), as_futureTime(вывод будущей даты), as_html(html код) и т.д. Тип отображения устанавливается определенной колонке след. образом:
array("тип", "текст с {переменной}", аргументы...), где аргументы устанавливаются вручную через запятую, а {переменная} используется в тексте для вывода содержимого колонки в БД. Чаще всего, аргументы указывать нет нужды, так как в текущей версии их очень мало.
Примеры:
array("as_name", array("Ник: {name}", 10)) - вывод никнейма до 10 символа(Ник: Alex, Ник: The_stas)
array("as_futureTime", 1), - вывод будущей даты с коэффициентом пропорциональности 1(то есть UNIX время хранится в секундах)
array("as_html", '<span onclick="banlist.formLinkByClient(\'{col-name}\')">{name}</span>', 'name' => array('as_name', array("{name}", 8))) - вывод html текста с использованием аргументов.
Важно! При прочтении инструкции обязательно заглядывайте в конфиг и соотносите взглядом все шаги данной инструкции с тем, что находится в самом конфиге. Помимо этого, внимательно читайте описание каждого параметра в конфиге, и вообще всё, что написано там русскими буквами: своего рода это тоже инструкция, первичная, когда не было данной. Так будет понятнее.
Главной особеностью является возможность широкой кастомизации мультилиста под определенный тип вывода данных.
Вы можете выводить данные постранично сразу из нескольких таблиц, которые могут находится как в одной БД,
так и в нескольких. Немаловажным является и ajax работа данного мультилиста: любые новые записи, добавленные в таблицу(-ы),
будут немеделенно отображены в мультилисте без перезагрузки страницы! Есть наличие ajax поиска. Мультилист отлично оптимизирован.
Например, из данного мультилиста в пределах настройки конфига можно сделать банлист, топлист(топ голосующих, топ богачей, топ играющих, ...), вывод игроков проекта и многое многое другое.
Как установить и настроить?
Часть 1. Общая настройка мультилиста
1. Скачайте мультилист, откройте архив, выберите папку с нужной кодировкой и откройте её. Далее переместите появившуюся папку 'multilist' в любое место вашего сайта через FTP протокол. После этого откройте multilist/config.php уже на сайте.
2. В блоке СЕРВЕРЫ укажите данные доступа к вашей базе данных. Если у вас несколько серверов и, следовательно, несколько БД, то добавьте через запятую новые серверы, указав им данные от другой БД. Если несколько серверов принадлежат одной БД, то нет необходимости указывать одни и те же данные: замените host, name, user... одним параметром ''link' => [Порядковый номер сервера],'(Как пример, посмотрите внизу)
3. Настройте остальные блоки, такие как ШАБЛОН, ВЫВОД, ПОСТРАНИЧНАЯ НАВИГАЦИЯ, кроме блока ТАБЛИЦА. К нему мы вернемся.
Часть 2. Настройка столбцов будущего мультилиста
Перед тем, как начать настройку, вы должны четко представлять, каким должен быть мультилист по структуре. Если вы решили сделать банлист, то вам необходимо правильно(как по вашему) организовать последовательность колонок и определить тип вывода данных в каждой колонке: если это никнейм, то можно вывести его как ссылку на профиль данного пользователя, а саму колонку разместить в начале. Например, правильная структура банлиста такова:
Сервер | Игрок | Забанил | Причина | Бан получен | Разбан
Если это топ богачей, то возможна след. структура: Место | Игрок | Денег. При этом в первом случае колонки Бан получен и Разбан нужно выводить как дату(DD.MM.YYYY HH:MI:SS), а не в голом виде UNIX(типа 1440635142), а во втором случае колонку Денег следует выводить как n рубл[ь,я,ей], то есть например: 1 рубль, 103 рубля, 5113 рублей.
Как только вы полностью определились со структурой, можно приступать непосредственно к настройке.
1. В блоке Колонки блока ТАБЛИЦА перечислены всевозможные колонки, которые будут выводиться в мультилисте. Их общий вид следующий: array(Колонка в БД, Название, Сортировка, Поиск, Тип отображения, Ширина столбца), где первые 5 параметров обязательны для заполнения. Данные колонки можно удалить или добавить новые через запятую. Такие параметры как Сортировка, Поиск требуют установки только true или false. Параметр Тип отображения необходим для установки соответствующего режима вывода. Внизу для справки(см. в конфиге) перечислены все возможные типы отображения: as_name(никнейм), as_time(вывод прошлой даты), as_futureTime(вывод будущей даты), as_html(html код) и т.д. Тип отображения устанавливается определенной колонке след. образом:
array("тип", "текст с {переменной}", аргументы...), где аргументы устанавливаются вручную через запятую, а {переменная} используется в тексте для вывода содержимого колонки в БД. Чаще всего, аргументы указывать нет нужды, так как в текущей версии их очень мало.
Примеры:
array("as_name", array("Ник: {name}", 10)) - вывод никнейма до 10 символа(Ник: Alex, Ник: The_stas)
array("as_futureTime", 1), - вывод будущей даты с коэффициентом пропорциональности 1(то есть UNIX время хранится в секундах)
array("as_html", '<span onclick="banlist.formLinkByClient(\'{col-name}\')">{name}</span>', 'name' => array('as_name', array("{name}", 8))) - вывод html текста с использованием аргументов.
Важно! При прочтении инструкции обязательно заглядывайте в конфиг и соотносите взглядом все шаги данной инструкции с тем, что находится в самом конфиге. Помимо этого, внимательно читайте описание каждого параметра в конфиге, и вообще всё, что написано там русскими буквами: своего рода это тоже инструкция, первичная, когда не было данной. Так будет понятнее.
