vBExperience 3.7 (aka xPerience)
--------------------------------
Автор: Marius Czyz (aka Phalynx).
Перевод: xDEAD
Победитель в номинации "Хак месяца" (Март 2008) на vBulletin.org.
Хак работает на vBulletin 3.7 и выше.
Описание
vBExperience - это расширенная система уровней и активности с магазином и наградами. Система ведёт подсчёт очков для каждого пользователя за его активность на форуме. Теперь ваши пользователи смогут увидеть как увеличивается их уровень, когда они учувствуют в жизни вашего форума.
Эта модификация была разработана мной, но я не был удовлетворён только очками получаемыми за сообщения, так как для крупных форумов нужно гораздо больше параметров, таких как: Являются ли сообщения полезными? Являются ли его темы популярными? Есть ли у пользователя фотографии, сопроводительные документы, которые он может показывать при общении? С помощью данного хака вы сможете ответить на эти и многие другие вопросы.
Демо:
http://www.insideearth.net/forum.php?langid=5
Демо профиля:
http://www.insideearth.net/member.php?u=1&langid=5
Демо статистики:
http://www.insideearth.net/xperience.php?langid=5
Демо наград:
http://www.insideearth.net/xperience...wards&langid=5
Демо повышений:
http://www.insidesupcom.de/xperience...=shop&langid=1
Демо магазина:
http://www.insideearth.net/xperience...=shop&langid=5
Демо статистики:
http://www.insideearth.net/xperience...stats&langid=5
Демо получаемых очков:
http://www.insideearth.net/xperience...=earn&langid=5
Здесь основные четыре критерия видимые для пользователя: Очки пользователя, его уровень, его очки в % и необходимые до следующего уровня, а так же его активность в %.
Подсчёт очков
Под подсчёт попадают такие вещи как:
Темы
- Создание тем
- Просмотры ваших тем
- Ответы в своих темах
- Голосования в ваших темах
- Теги (vBulletin 3.7)
- Ответы в ваших темах
- Прикреплённые темы
Сообщения
- Создание сообщений
- Скачивание вложений
Пользователь
- Дни после регистрации
- Рефералы
- Нарушения
- Репутация
- Публичные сообщения в профиле (vBulletin 3.7)
- Члены вашей социальной группы (vBulletin 3.7)
- Альбомные изображения (vBulletin 3.7)
- Друзья (vBulletin 3.7)
Другое
Также поддерживаются такие хаки, как:
- Post Thank You / Use of Post Thank You
- thanks via vS-Hide Hack Resurrection (Expanded Edition)
- LDM Links and Downloads Manager
- DownloadsII
- PhotoPost Gallery
- vBulletin Blog
- Who Downloaded This Attachment?
- Cyb Paypal Donate
- AWCoding-Donation System LITE and PRO (via addon)
- ibProArcade Highscorer Points (via addon)
- v3arcade Highscorer Points (via addon)
- PhotoPlog 2.1 (via addon)
- QuoteIt! 3.16 (via addon)
Расчёт активности
Система рассчитывает активность, беря во внимание среднее количество сообщений из десяти самых активных пользователей и сравнивая итоговое число с собственным значением.
Награды
По умолчанию существуют три награды: За общественность, За сообщения, За активность, За помощь. Награды отображаются в статистике и в профиле. Вы можете изменять позицию отображения наград в постбите(до/после ника пользователя). Существует запланированная задача, которая запускается раз в день в (02:30h) и награждает самых активных по данным критериям.
vBAdvanced
В архиве имеются два модуля для vBAdvanced 3.0: Самые активные пользователи и Пользователи с самым большим кол-вом очков. Импортируйте их с помощью админ панели vBAdvanced.
Настройки
Вы можете контролировать количество очков получаемых за любую вышеописанную активность на форуме. Например: количество очков за создание новой темы, за просмотры данной темы. Также можно отключать не нужные вам функции устанавливая значение 0.
К тому же, вы можете игнорировать пользователей (удобно для ботов), разделы (удобно для оффтоп(флуд) разделов) и группы пользователей.
Уровни
vBExperience работает с помощью определённых уровней сложности. Вам необходимо импортировать один из перечисленных ниже уровней, который будет наиболее подходить вашему форуму:
vbexperience_level_1_small.xml - для малых форумов с посещением до 3000 пользователей
vbexperience_level_2_average.xml - для средних форумов с посещением 3000-6000 пользователей
vbexperience_level_3_big.xml - для форумов с посещением более чем 7000 пользователей
vbexperience_level_4_huge.xml - если "big" не является большим для вас
vbexperience_level_5_very_large.xml - Huge тоже мало?
vbexperience_level_6_ultra.xml - Очень большое количество пользователей и сообщений
vbexperience_level_7_crazy.xml - Либо вы, либо ваши пользователи сумасшедшие ;)
Вы можете сделать свой собственный уровень который необходим именно вам - Я включала MS Excel лист с исходными данными, а также три XML образа для малого, среднего и крупного форума. Кроме того, у вас есть возможность облегчить или усложнить некоторые моменты учитывая, например, должности и повышения.
Создавать XML-файлы с помощью vBExperience_Level.xls очень просто. Необходимо скопировать его в текстовый редактор, удалить закладки и копировать в XML. Используя полученный результат вы сможете определить свои собственные уровни. Так что можете поэкспериментировать с XLS листом, чтобы добиться наилучших результатов, ведь вы ничего не теряете. В настоящее время поддерживаются уровни от 0 до 100.
Внимание: После изменения уровня, вам необходимо сделать перерасчёт при помощи инструментов встроенных в хак для удобства.
Было бы здорово включить в стандартный набор больше XML файлов - не стесняйтесь поделиться ими, а я в свою очередь буду добавлять их в будующих релизах.
Система повышений
Чтобы мотивировать пользователей активнее участвовать в жизни вашего форума, я создала систему поощрения. По достижению определённых точек, пользователь будет перемещён в другую группу, - где вы сможете настроить дополнительные возможности для пользователей, такие как: аватар и т.д.
Внимание: в настоящее время система изменяет основную группу пользователя - вы можете потерять ваших администраторов, потому необходимо настроить им дополнительную группу. По умолчанию данная функция отключена.
Влияние на производительность
vBExperience тестировался на мелких, а также на некоторых крупных форумах.
- vBExperience использует таблицу "user" для сохранения данных, потому никаких дополнительных запросов в постбите нет.
- В профиле добавлен один запрос собирающий статистику о пользователе.
- Каждые 10 минут один cron пересчитывает очки пользователей, которые создали новые сообщения после перерасчёта предыдущего cron'а.
- Каждую ночь, два cron'а пересчитывают сообщения за день. Это необходимо для того чтобы награждать самых активных пользователей. Подсчёт производится для всех пользователей, вне зависимости от их активности.
Установка
Продукт содержит дополнительные файлы и фразы. Никаких ручных изменений шаблонов не нужно. Два cron файла выполняют всё автоматически.
1. Загрузить все файлы из папки "upload" в корень форума.
(Так же в папке UTF-8 есть файл xperience_admin.php, который необходимо загрузить для корректной работы с данной кодировкой)
Используя стиль не по умолчанию, вы должны иметь ввиду, что вам необходимо копировать изображения в каталог вашего стиля.
2. Импортируйте главный продукт "product_vbexperience3718.xml"
3. Импортируйте уровень "vbexperience_level_1_?.xml".
4. Регулируйте параметры по своим потребностям
Обновление
1. Копируйте все файлы из папки "upload" в корень форума.
2. Импортируйте product_vbexperience3718.xml, разрешите перезапись
3. Верните все шаблоны vBExperience, если вы их редактировали
4. Запустите перерасчёт
Известные проблемы
- Если у вас не отображаются индикаторы в постбите(postbit) - у вас нет полностью совместимых шаблонов postbit/postbit_legacy с vBulletin 3.6.8/3.7. Для того чтобы исправить эту проблему вам нужна переменная $template_hook[postbit_userinfo_left] - убедитесь, что она находится в одном из этих шаблонов. Посмотрите на оригинальные шаблоны 3.6.8/3.7, чтобы увидеть где должна находиться переменная.
История изменений:
3.7.18 Beta 2, 07th October 2008
- Rankings: Fixed XSS Vulnerability (thanks to snunhuck and Y4I)15)
- Experience: Changed "post_thanks_thanked_times" to "post_thanks_user_amount" (post thank you hack)
- Shop: Fixed AdminCP, Manage Shop, "Transactionlog (Page %1$s/%2$s) | There are %3$s Entries."
- Shop: Fixed missing BBUrl Prefix
- Shop: Give Away is sending PM to receiver (setable)
- Shop: Selling item is sending PM to defined list (setable)
- Shop: Writing a PM upon a purchase can now be deactivated
- Shop: Improved "give away" and display in postbit/profile
- Shop: Set if points from purchased products should be substracted
- Awards: Award for activity is beeing set only to one user (more experience points wins), all other users are getting 99%.
- Awards: You can exclude usergroups from getting Awards. Administrators (Group ID 6) are excluded by default.
- Fixed unchached templates
- Known issue: Receiving a gift is disabling sell and give away of existing and new items of the same item as the gift. Beta 3 will address this.
3.7.18 Beta 1, 02nd October 2008
- Shop: User can sell item back to shop and get 75% points back (amount setable)
- Shop: User can give away item (gift) to someone
- Shop: Transactions in AdminCP are now paged
- Shop: User can see own transactions
- Shop: Categories have now an icon and a description
- New feature: Earn Points. It tells the user where and how he can get points. Title and description are pulled from phrases of the settings
- CDP: New revision of CDP to support Earn Points
- Added row breaker for profile shop items
В архиве только русский перевод. Кодировка UTF-8 присутствует.
Старался переводить как можно быстрее, потому если найдёте ошибки - исправим. Хак переведён полностью, не перевёл прилагаемые аддоны, потому как хотел как можно быстрее выложить перевод, да и времени не хватает, если нужно - переведу.