1. This plugin lets you easily determine where you have unread or read topics. Where the active
sections and active topics are. It also has the ability to give different styles to section
and topics depending on their read and active state. It also can allows you to provide different
icons for active sections. As well these forum enhancements. You have a page where you can search
and display the new or updated topics since a configurable time.

Version 1.3 15/05/2006
* Now follows groups and rights system correctly.

Added:
* If a user doesn't have rights to view forum. They wont be able to view ActiveHighlight page.
* If a user doesn't have rights to view forum section. It will not show on ActiveHighlight page.
* If forums are disabled. ActiveHighlight will also be disabled.
* user can link to the ActiveHighlight page with variables in the url.

* variables:

- &since = (int) (time stamp, how far back to show posts from)



- &replied = (BOOL) ( Only show topics with no replies ) 1 = yes, no replies. 0 = both, with and without replies.
Default: 0

For example:

then u can do a link like so:

e]


Version 1.2 21/04/2006
* Topic links in ActiveHighlight page now go to last#bottom page.
* forum.section unread tag FORUMS_SECTIONS_ROW_ACTIVEHIGHLIGHT_COUNT now link to ActiveHighlight page.
* Extended cookie to last 4 weeks extra after each post viewed.
* Added only show topics with no replies check box on ActiveHighlight page.
* Guests are allowed to view and use ActiveHighlight page.

Added:
* Tags
{REPLIED_CHECKBOX_CHECKED}
{PHP.L.NoReplies} - see language file.

Bug Fixed:
* ActiveHighlight page showed old posts as unread.

See section 4. Installation.


Version 1.1 20/04/2006

Bug Fixed:
* Fixed bug causing malformed headers. Due to cookie data doubled by post count.
* Fixed wrong rowspan count for plug.hope=ActiveHighlight last row. If the row was greater
then one. The count would still be one a column would be missing.
* Added SQL code to ActiveHighlight.posts.php to fix $fp_updated with its unix stamp.
So only new posts are checked.

Enhancements:
* If cookie is missing the post will return unread if it is newer than last visit.

Install:
If you have been using V1,0 of this mod. You must follow step 4 below once again, and
re-install. As a hook has changed and must be updated in the config.

Version 1.0
--first-

* Different Icons for active sections. Sections with new posts.
* Add a style to topics that you have read.
* Add a style to topics you have not read.
* Add a style to sections that have new posts and unread posts.
* Add a style to sections that have new posts that you have read.
* Add a style to section that have no new posts.
* View new posts since choice and easily see what you have read already.
* Distinguish between read and unread posts using the styling feature.


2. Requirements

* Seditio. Tested on version 1.0

4. Install:

A. Extract the folder 'ActiveHighlight' from the file unread.rar and place
it in your plugins/ directory.

B. login as admin. Go to Administration panel / Plugins. Click on
ActiveHighlight and press install.

C. Edit the options of the plugin by going to,
Administration panel / Plugins. Click on the 'EDIT' button.
Next to the plugin 'ActiveHighlight'. Edit the configuration how you desire.

D. Create a language file to match that of your site.
This file should be created in plugins/ActiveHighlight/lang/.

E. Add the tags to the skin files. +create any images

The ActiveHighlight plugin has the following tags:

For forums.sections.tpl
{FORUMS_SECTIONS_ROW_ACTIVEHIGHLIGHT_COUNT}
How many topics/posts are active and unread in this section.
This will contain the word "ActiveHighlight" (check language file) if
there is unread topics. It will be "" if there is no unread
topics.

I placed this under the forum section row title. e.g..



Notice the <br /> to bring it to a new line.
You can place it anywhere in the row however.


This will be the url to either:

If the forum section has new posts - skins/$skin/img/active_section.gif";
If the forum section has new no posts - skins/$skin/img/inactive_section.gif";

You must create these two images and place them in your skin folder under them names.

To use the tag, link to the image and use the {FORUMS_SECTIONS_ROW_ACTIVEHIGHLIGHT_ICON_ALT}
tag as its alt.



{FORUMS_SECTIONS_ROW_ACTIVEHIGHLIGHT_ICON_ALT}
Will either contain "New Post" if the icon is to be active_section.gif.
Or contain "No New Post" if the icon is to be inactive_section.gif.

{FORUMS_SECTIONS_ROW_ACTIVEHIGHLIGHT_STYLE}
This tag must be used in conjunction with html to add a style to the title
of the forum section. It will contain the style set in the configuration
for the unread plugin. That is appropriate for the section title.



Place the tag as or in with the style for the title.

For forums.topics.tpl
{FORUMS_TOPICS_ROW_ACTIVEHIGHLIGHT_STYLE}
This tag must be used in conjunction with html to add a style to the title
of the forum topics. It will contain the style set in the configuration
for the ActiveHighlight plugin. That is appropriate for the topic title.

<a style="{FORUMS_TOPICS_ROW_ACTIVEHIGHLIGHT_STYLE}" href="{FORUMS_TOPICS_ROW_URL}">{FORUMS_TOPICS_ROW_TITLE}</a>

Place the tag as or in with the style for the title.

For ActiveHighlight.tpl
{ACTIVEHIGHLIGHT_PAGETITLE}
This tag just holds the title of the page.

{TOPIC_AMOUNT}
This tag holds the integer count for how many topics to show per section.
This tag is set by the input box "amount".

{SINCE}
This tag holds the time to find new posts since. This tag is set by the
select box "since".

{SINCE_OPTIONS}
This tag just contains the options for the select box. This tag is used so that
the options can be set selected.

{CATEGORY_ROW_TITLE}
This tag holds the category title for the section row.

{SECTION_ROW_TITLE}
This contains the section title for the topics.

This topic is usually used with a link along with the SECTION_ROW_URL tag.
You can use it how you wish.
<a href="{SECTION_ROW_URL}">{SECTION_ROW_TITLE}</a>

{SECTION_ROW_SPAN}
This contains the length that the rowspan. This is equal to the count of topics
for this section.

This tag should be used with the rowspan html tag.
<td rowspan="{SECTION_ROW_SPAN}">

{SECTION_ROW_URL}
This is the url for the row title. It links to the section in the forums
of the title.

This tag should be used in a link.
<a href="{SECTION_ROW_URL}">{SECTION_ROW_TITLE}</a>

{TOPICS_ROW_ODDEVEN}
This is build odd or even. So you can set in your css different colours for
each row.

This tag should be used with the class html tag.
<td class="{TOPICS_ROW_ODDEVEN}" >

{TOPICS_ROW_ACTIVEHIGHLIGHT_STYLE}
This tag contains the style for the topic. Depending on your configuration
and the read state for that topic.

This tag should be used with the html style tag. For example.
<a style="{TOPICS_ROW_ACTIVEHIGHLIGHT_STYLE}" href="{TOPIC_ROW_URL}">{TOPIC_ROW_TITLE}</a>
<br />

{TOPIC_ROW_DATE_CREATED}
This tag is the date of creation for the topic in this row.

{TOPIC_ROW_FIRSTPOSTER}
This contains a link with value of the first posters name.
It links to their profile

{TOPICS_ROW_UPDATED}
This will be the date the last post was created in this topic.

{TOPICS_ROW_LASTPOSTER}
This will be a link with value of the name of the last poster
in the topic. It will be a link to the profile of this last poster.

{TOPICS_ROW_TIMEAGO}
This tag will contain the time difference between he first and the last post
in this topic.

{TOPICS_ROW_POSTCOUNT}
This tag will contain the post's posted in this topic row.

{TOPICS_ROW_VIEWCOUNT}
This tag will contain the topics views.

Added in 1.2

{REPLIED_CHECKBOX_CHECKED}
This tag just sets if the checkbox was previously checked or not.


F. Create button on your site somewhere. This is up to you. The href, or link
should be 'plug.phpşe=ActiveHighlight'

This links to the Active Highlight page.

G. Finished.

5. Uninstall:

A. Go to Administration panel / Plugins. Click on ActiveHighlight and press 'Uninstall'.

B. Delete the ActiveHighlight directory from the Plugins folder.

C. Remove the following tags from the skin forums.topics.tpl.
FORUMS_TOPICS_ROW_ACTIVEHIGHLIGHT_STYLE

D. Remove the following tags from the skin forums.topics.tpl.


E. Finished.

6. Report Bug's , Requests:
If you would like me to change or add something. If you find a bug, Feel free to contact me. You can find details
of where to find me at the top of this file. Either e-mail or search forums for my name. My name is "Elgan" in both.