Lil Devil's Geocaching Pages

This script adds a useful display to help you quickly find your friend's and family's logs, and to easily determine if you've found the cache or not. You can also show or hide certain subsets of logs from the cache logs display.

Install the VIP List script

Install the helper script - changes links to cache pages to go directly to "all logs" page.

What This Script Does

On the right-hand side of each cache page, a summary of cache logs is shown. Only logs that were written by a configurable list of VIPs is included in this list of logs. Your VIP List might include your friends, family and any other Very Important Persons that you wish to keep an eye on. Each log is shown in a color which denotes why that log is shown in the VIP Logs area. Hover your mouse over the icon to see a helpful legend.

You can add or remove people to the VIP List using several different methods, which are documented below.

For a quick indication of whether you've found a cache or not, a smiley is added next to the cache title if you've found the cache, or a frownie is added if you've logged a DNF. This indication is based on the logs shown on the page - if only 5 logs are loaded, but your log is the 8th, there will be no indicator. Clicking on the smiley or frownie will scroll the page down to your log entry.

If the cache is one of your own caches, a "mine" icon will be added next to the cache name, just like on the nearest cache list. The script will determine the true cache owner even if something else is put in the "hidden by" field.

When a cache page is first loaded, it typically only shows the first 5 logs. In this case, only those VIP logs that are included in the first 5 logs will be shown in the VIP Logs area, and a warning will alert you to this condition. Simply click on the "Load more logs" link to load the rest of the logs. Alternately, you can turn on the option to "always load all logs." If you use this option, it is highly suggested to also install the helper script, which rewrites links to directly load all logs when opening a cache page. Without the helper script, cache pages will load with just 5 logs, then reload to show all the logs.

When all cache logs are displayed, the icons for each log type can be clicked to take you to the first log of that type. For your convenience, if all cache logs are not displayed, the script copies the "There are more logs. View them all on one page" link so it also appears above the logs.

Got Friends?

Have you been collecting friends on your Friends List? If so, you can quickly add them all to your VIP List by clicking on the link at the top of that page. You can also click on the individual badges next to each friend to add or remove each one to or from the VIP List.

If you don't have any friends, don't worry; there are other ways to add cachers to your VIP List. The first way is to find their cache log on a cache page, and click on the badge next to their name. When you click on the badge, it's color will change to blue to indicate it is on the VIP List. Badges for the cache owner will be green and badges for you (the logged-in user) will be red. If you forget what these colors mean, just hover your mouse over the icon to see a helpful legend.

Another way to add cachers to the VIP List is to click on the link. This will bring up the current VIP List. You can remove cachers by clicking their name. The link will turn red with a strikeout to indicate it is being removed. Click it again to add it back. Click the "Add" button to manually enter a name to be added to the VIP List. Names are not case-sensitive. Click the "Save" button to save your changes or "Cancel" to discard all changes.

Yet another way to add cachers to your VIP List is from their profile pages. Just click on the badge next to their name at the top.

Show Only the Logs You Want to See

Don't you wish you could do these things?

1. While looking at a cache page with hundreds of logs, you only want to read the logs of your VIPs, without the distraction of all those other logs.
2. You're looking at a cache page that has hundreds of finds, but there are a few "did not find" logs mixed in. That doesn't make sense because it's such an easy cache. It would be interesting to read those DNF logs, but finding them among all the other logs is difficult.
3. You're hosting an event and you want to see only the Will Attend logs, without all those "can't attend" notes showing up.

Now you can do all that and more. Two buttons have been added to the title bar of the Cache Logs area, which give you the ability to hide or show all the cache logs. When the cache logs are hidden, clicking on a link in the VIP Logs area or the Logged Visits totals, will un-hide those logs, as well as scroll the window to the first one in the group. The title at the left end of the title bar shows how many logs are visible.

Using the first wish above as an example, you would first click on the button, then scroll up to the VIP Logs, and click on the icon at the top of the VIP Logs area. This will show (un-hide) all the VIP Logs and scroll the window to the first one.

To accomplish the second wish, you would first click on the button, then go to the Logged Visits totals, and click on the icon. This will show (un-hide) all the DNF logs and scroll the window to the first one.

To show all logs again, simply click on the button.

Note: Showing and hiding hundreds of logs at one time can take a long time. I've done some testing and found that my code to hide or show the logs runs in just a fraction of a second, but the browser then takes several seconds to actually re-draw the window. Be patient when working with cache pages with lots of logs.

Configuration

Display Options

This script has several configurable options. To configure them, click on below the VIP Logs.

"Include VIP logs in list" - When this option is enabled, logs written by cachers on the VIP list will be linked in the VIP Logs box. Usually you will want this option turned on, but sometimes it is useful to turn this off temporarily to highlight other categories of logs.

"Highlight your own logs" - When this option is enabled, the logged-in user's logs will be highlighted in red. This makes it easy to find your own logs. Additionally, if the "Include in list even if not a VIP" box is checked, you don't need to add yourself to the VIP List to see your logs summarized in the VIP Logs area.

"Highlight the cache owner's logs" - When this option is enabled, the cache owner's logs will be highlighted in green. This makes it easy to find the cache owner's logs. If the "Include in list even if not a VIP" box is checked, you don't need to add the cache owner to the VIP List to see the cache owner's logs listed in the VIP Logs area.

"Highlight multiple "found" logs by the same person" - When this option is enabled, and a cacher has logged a find (found, attended, etc.) more than once on the same cache, his logs in the VIP Logs List will be shown in bold. If the "Include in list even if not a VIP" box is checked, even non-VIPs will be shown in the VIP Logs area if they logged multiple finds.

"Indicate logs that have images" - When this option is enabled, a picture frame icon will be shown next to each VIP log that has pictures. Clicking on the picture frame will show the images for that log, just as if a picture frame in the log itself was clicked. If the "Include in list even if not a VIP" box is checked, all logs with images will be shown in the VIP Logs area.

Tip: When viewing images in the "lightbox" photo viewer, and there are multiple images, clicking the right- or left-half of the image will advance to the next or previous photo, respectively. This way only one link is needed, even if there are lots of images with that log.

"Show instructions if there are no VIP logs" - When this option is turned on, some brief instructions on how to add VIPs will appear when there are no VIP logs. These instructions automatically disappear if there are VIP logs. You can turn this option off after you become familiar with how this script works.

"Show VIP badges" - This option controls whether the badges are shown next to the cache logs. Turning this option on makes it more convenient to add or remove cachers from your VIP List, while turning this option off will speed up the script, especially when viewing caches with a large number of logs.

"Always load all logs" - When this option is on, cache pages will automatically show all the logs. If you install the helper script, links that point to cache pages will be adjusted so they load all the logs when clicked. Without the helper script, cache pages will load momentarily without all the logs, then reload with all the logs.

Date Options

Date formats - Here you can specify how to show dates in the VIP list, on logs, and for the cache hide date. The following tokens are available for formatting dates just about any way imaginable.

Token	Description	Example
d	Day of month.	1-31
dd	Day of month with leading zero.	01-31
s	The date’s ordinal suffix.	st, nd, rd, th
DD	Day name.	Sunday, Monday
D	Abbreviated day name.	Sun, Mon
RR	Relative day name.	Last Tuesday, Yesterday, Today
R	Abbreviated relative day name.	Last Tue
m	Month number.	1-12
mm	Month number with leading zero.	01-12
MM	Month name.	January, February
M	Abbreviated month name.	Jan, Feb
yy	Two digit year.	00-99
yyyy	Four digit year.	1999-2010
Meta-tokens - These special codes will include any tokens between their brackets only if …
w{…}w	… the date is within a week of today’s date.
W{…}W	… the date is not within a week of today’s date.
y{…}y	… the date is in the current calendar year.
Y{…}Y	… the date is not in the current calendar year.
Examples M dY{, yy}Y - Shows an abreviated month, followed by the day of month, followed by a 2-digit year, but only shows the year if it's not this year. - (e.g. "Feb 11" or "Dec 10, 09") RR, MM dsY{, yyyy}Y - Shows the relative day of week, followed by the full month name, followed by the day of week with ordinal suffix, followed by the full year if it's not this year. (e.g. "Today, January 11th" or "Yesterday, January 10th" or "Friday, December 25th, 2009") m/d/yy - short U.S. date format - (e.g. 2/11/10) d/m/yy - short euro date format - (e.g. 11/2/10)

Hover your mouse over the icon to see a helpful table showing all the possible tokens.

"Position" - Use this menu to choose where the VIP List will appear. It can be anywhere on the right-hand side of the cache page, from above the "Navigation" pane, to below the "Bookmarks" list.

Version History

3.0 - 2010/02/11

• Added an option to always load all logs.
• Added a legend to show what the different colors and shading mean.
• Added helpful tooltips to all links and images created by this script.
• Added an option to show a picture frame next to logs in the VIP List that have images. Clicking on it will show the images.
• Added an option to show dates in user-defined formats (e.g. M/D/Y or Y/M/D etc.)
• After changing the VIP list or options in one window or tab, update any other windows or tabs that also show the VIP List.
• Added an option to denote who has logged multiple finds on the same cache.
• Added "mine" icon next to the cache name for caches owned by the logged-in user.
• Added compatibility with the Geothumbs greasemonkey script.
• Adjusted the way the "Add all friends" link is added to the My Friends page, for better compatibility with my Friends List Enhancements script.
• Fixed the "Add all friends" function to work even if the VIP badges are not currently shown.
• Lengthen background when adding names to the VIP List.
• Fixed detection of the true cache owner's name when there is something random shown for the hider on the cache page.
• Better handling of usernames with special characters.
• Reworked to accommodate 2010/01/12 website changes.
• Various minor enhancements and bug fixes.

2.0 - 2008/08/13

• Show logs for a list of VIPs, instead of only self's logs.
• If only the first 5 logs are shown, show a partial log list.
• Make the VIP List box look like other (Nav, TBs, etc.) boxes.
• Add VIP badge next to user's name at top of each log.
• Add VIP badge next to the cache owner's name.
• Add VIP badge next to logged-in user's name.
• When user clicks on a "log totals" icon, go to the first log of that type.
• Add a smiley to the top of the page, next to the cache name, to show if the logged-in user has found or DNF'd the cache.
• Add code from my obsolete Block Collapser script, to enable collapsing of the Cache Logs area.
• Show the number of visible logs in the Cache Logs title bar.
• Add VIP badge to the profile page.
• Add VIP badges to the Friends List page.

1.3 - 2006/03/04

• Geocaching VIP List was originally based on Prime Suspect's True Totals script v1.3. I almost completely rewrote it to add many features I felt were missing in the original script.