Документация1. Переход на страницу темы по её номеру.
Чтобы открылась форма для ввода номера страницы нажмите на слово "Страниц:" вверху или внизу темы. Повторное нажатие скрывает форму. Далее всё очевидно.
Обратите внимание, если скрипт установлен, то слово "Страниц:" полужирное:
2. В Архиве нормально работают ссылки "Подтвердить" и "Удалить" (ссылки расположены под каждым сообщением в Архиве).
Здесь ничего особенного, жмёте на ссылку и смотрите на результат, страница перегружаться не будет (так было в первой версии).
3. На страницах форума не прописаны ссылки на почтовый ящик. Скрипт находит нужные места и подставляет в них правильную ссылку. Первая ссылка находится в правом верхнем углу под строкой "0 новых писем". Вторая ссылка находится во второй строке сверху под словом "Почта", это там где "Мой кабинет", "Журнал", "Архив" и "Выход". Теперь обе эти ссылки ведут в почтовый ящик. Ссылки работают на всех страницах сайта, где они есть.
4. Если в сообщение вставить какую-нибудь ссылку, то форум автоматически преобразует её из текста в гипертекстовую ссылку, даже если её не заключать в теги url. Но если ссылка длинная и не содержит каких-нибудь символов, позволяющих разбить её на строки, то практически все браузеры, кроме Firefox 3, выводят такую ссылку в одну строку, в результате страница становится очень широкой и её становится неудобно читать.
После загрузки страницы скрипт находит все такие ссылки, и если ссылка длинной более 80 символов, то он из заменяет текст превышающий длину в 80 на "...", таким образом получается ссылка длиной в 80 символов, и в результате форматирование страницы не портится. При этом ссылка остаётся рабочей. Изменённые таким образом ссылки выводятся курсивом.
См. пример на
этой странице.
5. Форма поиска находится на всех страницах форума. Именно на страницах форума, а не сайта, например, её нет в
статьях и
архиве. При этом она доступна как зарегистрированным, так и не зарегистрированным пользователям.
Чтобы открыть форму поиска нажмите ссылку "Поиск с Google", расположенную в правом верхнем углу страницы.
Чтобы скрыть открытую форму, повторно нажмите на ссылку "Поиск с Google".
Форма поиска при просмотре темы отличается от формы поиска на других страницах форума тем, что в ней есть галочка "Только в текущей теме". Если эта галочка установлена, то поисковый запрос будет уточнён так, чтобы в результаты попали в основном страницы принадлежащие этой теме. По умолчанию, эта галочка установлена.
После ввода запроса и нажатия кнопки "Поиск" (можно просто нажать Enter), будет открыта
новая страница с результатами поиска. На самой странице форума форма поиска будет скрыта, но строка поиска не очистится. Таким образом, если вернуться на страницу и нажать на ссылку "Поиск с Google", то появится форма, содержащая последний поисковый запрос.
6. Ссылки на скрытые разделы форума находятся вверху страницы, под именем пользователя:
Про ссылку "Настройки скрипта" см. ниже в пункте 9.
7. При сохранении закладки по умолчанию на форуме выдаётся сообщение. Вот как оно выглядит в Opera:
Если включить настройку "НЕ выдавать сообщение после установки закладки", то при сохранении закладки сообщение выдаваться не будет, вместо этого изображение якоря будет обведено рамкой:
По умолчанию, эта функция
отключена.
8. На
первой странице форума есть несколько разделов (например, "Важное" и "Главные конференции"), в каждом разделе отображается несколько тем. При этом видны как темы, в которых все сообщения прочитаны, так и темы, в которых появились не прочитанные сообщения. Непрочитанные темы отмечаются значком:
.
Скрипт автоматически может скрыть все прочитанные темы, так что будут видны только темы с новыми сообщениями. Это избавляет от прокручивания страницы для поиска тем с новыми сообщениями, т.к. они будут более компактно отображены.
По умолчанию, эта функциональность
отключена. Чтобы её задействовать надо включить настройку "Сворачивать прочитанные темы после загрузки главной страницы".
Если эта функция включена то после загрузки страница будет выглядеть так:
При этом над каждым разделом появляется ссылка "РАЗВЕРНУТЬ". При нажатии на неё в этом разделе отобразятся скрытые прочитанные темы, а ссылка изменится на "СВЕРНУТЬ". При нажатии на ссылку "СВЕРНУТЬ", прочитанные темы опять будут скрыты.
На рисунке выше, в разделе "Важное" все темы прочитаны, поэтому в нём не отображается ни одной темы, для их просмотра есть ссылка "РАЗВЕРНУТЬ". Раздел "Главные конференции" содержит три непрочитанные темы, но в нём также отображены прочитанные темы, т.к. была нажата ссылка "РАЗВЕРНУТЬ", и теперь она изменилась на "СВЕРНУТЬ". Раздел "Специальные конференции" содержит две непрочитанные темы и шесть прочитанных, но непрочитанные темы не видны, т.к. раздел свёрнут.
9. Часть функциональности скрипта регулируется настройками, т.о. некоторые функции можно отключать оставляя только необходимые вам.
Чтобы открыть настройки надо нажать на ссылку "Настройки скрипта", расположенную в левом верхнем углу экрана. При нажатии на ссылку появится диалоговое окно:
Чтобы зарыть это окно без изменения настроек можно повторно нажать на ссылку "Настройки скрипта" или на кнопку "Отменить", при этом никакие сделанные изменения сохранены не будут.
Если нажать на кнопку "Сохранить", то настройки будут сохранены, а текущая страница
перегружена. Поэтому не сохраняйте настройки при редактировании сообщений, если не хотите потерять сделанные изменения.
Все настройки хранятся на компьютере пользователя, т.о. если вы пользуетесь форумом на работе и дома, то настройку надо будет производить в обоих местах.
В Firefox настройки сохраняются в локальном хранилище. Чтобы их просмотреть перейдите по адресу about:config и найдите строку с именем "greasemonkey.scriptvals.userscripts.org/Avanturist.org.PATCH.york_settings".
В Opera нет специального хранилища для настроек, поэтому они хранятся в cookies. Следовательно, если ваш браузер очищает cookies после закрытия, то настройки не будут сохранятся после перезапуска браузера.
10. Скрипт может автоматически сворачивать сообщения оставленные определёнными пользователями. При этом он руководствуется либо "чёрным", либо "белым" списком пользователей. Если выбрана фильтрация по "чёрному" списку, то будут сворачиваться все сообщения пользователей, находящихся в "чёрном" списке. Если выбрана фильтрация по "белому" списку, то будут сворачиваться сообщения от всех пользователей не входящих в "белый" список. Ваши сообщения отображаются всегда.
Над каждым свёрнутым сообщением появляется ссылка "РАЗВЕРНУТЬ", нажав на которую можно просмотреть сообщение. После этого сообщение опять можно скрыть нажав на ссылку "СВЕРНУТЬ", которая появится вместо ссылки "РАЗВЕРНУТЬ".
Вот как это выглядит:
На рисунке SergeB в "чёрном" списке, поэтому его сообщения автоматически скрываются. Первое сообщение на рисунке свёрнуто, а второе развёрнуто.
Напротив имени каждого пользователя, чьи сообщения отображаются, есть символ "
X" (см. рисунок выше). Его поведение зависит от текущего режима. Если выбрана фильтрация по "чёрному" списку, то при нажатии на "
X" пользователь будет занесён в "чёрный" список. Если используется "белый" список, то при нажатии на "
X" пользователь будет удалён из "белого" списка.
Напротив имени каждого пользователя, чьи сообщения скрываются, есть символ "
+" (см. рисунок выше). Его поведение зависит от текущего режима. Если выбрана фильтрация по "чёрному" списку, то при нажатии на "
+" пользователь будет удалён из "чёрного" списка. Если используется "белый" список, то при нажатии на "
+" пользователь будет добавлен в "белый" список.
Т.е. нажатие на "
X" приводит к тому, что все сообщения пользователя будут скрываться, а нажатие на "
+" наоборот переводит сообщения пользователя в разряд отображаемых. При нажатии на любой из этих символов будет выдан запрос, после утвердительного ответа пользователь заносится в список или удаляется из списка, и текущая страница перегружается.
Выбрать тип используемого списка и просмотреть список пользователей можно в настройках.
В списке отображаются идентификаторы пользователей. В Firefox в скобках отображается имя пользователя, в Opera имени пользователя нет. (Сделано это потому что в Firefox настройки хранятся настройках браузера, а в Opera в cookies. Т.к. cookies передаются на сервер в каждом запросе, желательно не делать их очень большими.)
Через настройки можно удалять пользователей из списка. Для этого надо выделить строку в списке пользователей и нажать кнопку "Удалить".
Чтобы настройки сохранились надо нажать кнопку "Сохранить", если этого не сделать, то настройки не будут изменены.
После нажатия на кнопку "Сохранить" страница перегружается, и отображается уже с учётом сделанных изменений.
11. Развитие автоматического сворачивания разделов (см. пункт 9 документации).
На форуме в сутки в среднем появляется по 680 сообщений (
в октябре новых сообщений - 21208, делим на 31 день), чтобы все их прочитать нужно очень много времени. Поэтому я читаю только несколько интересующих меня тем. Отсюда возникает деление на отслеживаемые и неотслеживаемые темы.
Скрипт помогает не обращать внимание на неотслеживаемые темы, скрывая их на
главной странице не смотря на то, что в них есть новые сообщения.
Как это выглядитСвёрнутый раздел "Разговоры":
Развёрнутый раздел "Разговоры":
На рисунках выше есть отслеживаемая тема "улыбаемся и машем, парни!", она содержит новые сообщения и видна и свёрнутом и развёрнутом виде. Также есть новая тема "Космическая китайская мистификация", она также видна в обоих случаях.
На втором рисунке есть тема "Компьютерные игры. Виртуальное отражение реальности", она содержит новые сообщения, но не видна в свёрнутом виде, т.к. это неотслеживаемая тема.
Работает это следующим образом. Тема может находиться в одном из трёх состояний:
- Отслеживаемая.
- Неотслеживаемая.
- Новая тема, про которую неизвестно, является она интересной или нет.
Все эти темы по разному отображаются на первой странице (см. рисуноки выше).
Отслеживаемая тема выглядит как обычно, и если в них появляется новое соощение, то она будет отображена в разделе.
Неотслеживаемая тема, также выглядит как обычно, но независимо от наличия новых сообщений, на главной странице она всегда скрывается.
Новая тема, отмечается надписью "
Новая тема: отслеживать /
не отслеживать".
Слова "
отслеживать" и "
не отслеживать" являются ссылками. При нажатии на ссылку тема переводится в соответствующую имени категорию.
Как это реализованоОтслеживаемой считается тема, в которой установлена закладка ("якорь"). Если вы не пользуетесь закладками, достаточно установить закладку на любое сообщение темы, чтобы она стала считаться отслеживаемой.
Неотслеживаемой считается тема, в которой установлена специально сформированная закладка. Такие закладки формировует скрипт при нажатии на ссылку "
не отслеживать".
Новая тема - это тема, на которой вообще нет закладок. При нажатии на одну из ссылок "
отслеживать" или "
не отслеживать" будет сформирована закладка соответствующего типа и тема перейдёт в одну из двух предыдущих категорий.
Закладки хранятся на сервере (в отличии от настроек, хранимих на компьютере), значит независимо от того, где вы читаете форум, деление тем на отслеживаемые и неотслеживаемые одно и тоже.
12. Меню скрипта.
Скрипт добавляет на каждую страницу форума своё меню.
На всех страницах форума в этом меню есть пункт "Настройки", остальные пункты зависят от текущей страницы.
В настоящий момент есть только два дополнительных пункта - это "Свернуть все разделы" и "Развернуть все разделы". Они отображаются если открыта первая страница (см. рисунок выше). Назначение этих пунктов меню, думаю, понятно из их названия
, и относится к автоматическому сворачиванию разделов, описанному в 9 и 11 пунктах документации.
13. Автоматическое форматирование таблиц, т.е. расстановка тегов [table], [tr], [td].
В форме отправки/редактирования сообщения появилась новая кнопка
, самая первая после кнопок для таблиц.
Теперь таблицы можно форматировать так:
- Делается таблица в Excel и копируется или копируется готовая таблица с какой-нибудь интернет страницы.
- Таблица вставляется в сообщение. Вставленная таблица не отформатирована, её ячейки разделены табуляцией (это такой большой пробел), а строки обычными разрывами строки.
- Выделяете всю таблицу и жмёте новую кнопку .
В тексте сообщения появляются нужные тэги.
14. Отрисовка границ у таблиц в сообщениях.
Для этого появилась новая настройка "Рисовать границы у таблиц в сообщениях", после её включения все таблицы будут иметь границы, и дополнительно текст в первой строке будет полужирным.
По умолчанию эта возможность отключена.
15. В форму отправки/редактирования сообщения добавлены кнопки для вставки URL
, цитат
и кнопка для вставки тега CODE
.
Кнопка CODE
работает как и другие кнопки для форматирования текста. А кнопки URL
и цитата
немного отличаются. Их можно использовать следующим образом:
- Выделить текст ссылки/цитату, нажать нужную кнопку появится запрос для вставки URL/источника цитирования. Вставляете URL/источник цитирования, нажимаете OK и получаете готовую ссылку/цитату.
- Ничего не выделяете жмёте нужную кнопку, у Вас также запрашивается URL/источник цитирования. Вставляете его. После этого вписываете между тегами текст ссылки/цитаты.
16. Автоматический поиск сообщения при переходе по ссылке вида http://www.avanturist.org/forum/index.php/topic,
N.msg
NNN.html#msg
NNN.
При переходе по ссылке из заголовка цитаты, при переходе к закладке, а также при переходе по многим другим ссылкам, которые должны вести к определённому сообщению, попадаешь не на то сообщение, на которое хотел, а на несколько страниц раньше или позже.
Эту проблему просто так не решишь, но кое-что я всё же сделал: если при переходе к сообщению была загружена страница, не содержащая его, то скрипт автоматически начинает искать это сообщение.
Подробнее смотрите в
этом сообщении.
Поиск сообщения по умолчанию отключён, чтобы его включить есть специальная настройка.Автоматический поиск сообщения писался с расчётом на то, что он будет работать независимо от того, какой порядок вывода сообщений. Но я его не тестировал для случая, когда новые сообщения появляются в начале темы, поэтому если что-то будет работать не так, сообщайте, будем разбираться.
17. Добавление ссылок на оригинал к уменьшенным изображениям без ссылок.
Теперь можено кликнуть по любой уменьшенной картинке, на которой раньше не было ссылок, и она откроется в новом окне и будет нормального размера.
Эта возможность по умолчанию отключена, чтобы её включить есть специальная настройка.
18. В сообщениях в закрытых темах добавлена кнопка
.
Внимание!. Кнопка "Сохранить в архив" не исчезает с сообщений в закрытых темах, которые уже есть в Архиве.
19. Возможность удалять и восстанавливать удалённые закладки.
Чтобы появились/исчезли элементы управления закладками надо нажать на ссылку "Показать управление закладками" / "Скрыть управление закладками" в меню скрипта.
При нажатии на ссылки "
Удалить закладку" и "
Восстановить закладку" должна открыться страница содержащая:
{result: "1"} Это признак того, что закладка удалена/восстановлена.
Если удалить/восстановить закладку не удалось, будет загружена примерно следующая страница:
{result: "0", resultStatus: "<СООБЩЕНИЕ ОБ ОШИБКЕ>"} Где вместо
<СООБЩЕНИЕ ОБ ОШИБКЕ> будет текст сообщения об ошибке.
После этого, если перейти на
первую страницу форума, то можно увидеть сделанные изменения, но лишь после того, как будет загружена не кэшированная страница. Кэшированная первая страница не имеет тэга title, т.е. в этом случае в заголовке браузера пишется "http://www.avanturist.org/forum/index.php", если страница не кэшированная, а обновлённая, то тэг title присутствует и в заголовке браузера пишется "Форум - Главная страница".
Внимание! Темы, у которых удалена закладка автоматически сворачиваются даже если в них есть новые сообщения, если конечно в настройках включено сворачивание разделов.
