Helping with Help!

Knowing I couldn't possibly keep up with all of the going-ons in letterboxing, I created a help page that's actually a wiki--allowing any members on Atlas Quest to add to and edit the help pages. This is great for a couple of reasons. First, I don't know everything. (It's true!) When it comes to the intricacies of postals or LTCs, I'm not an expert. Second, things change--sometimes, I don't even realize it--and therefore the documentation needs to be updated. Third, I'm my spelling is atrocious and there are often typos in anything I right that spell chekers don't necessarily katch. I'd just as soon let you guys fix it right then and there than have to e-mail me to fix a simple typa. ;o)

So a wiki seemed like just the solution. If I overlooked something, you can add it yourself. If I got something wrong, you can fix it yourself. If something changed, you can fix it yourself.

Normally, I'd try to check the list of Recent Additions and Changes at least once per month to see how things were going, answer unanswered questions, and check that people aren't adding junk to the help pages, but this also meant that cases of vandalism (which has happened on occasion) could sit unnoticed for days or weeks at a time, and people with questions may not get answers as promptly as they wanted. And while I was off hiking the PCT, I didn't check this list at all!

Surely, there must be a better way....

...and now there is! =) If you go to your Notifications & E-mail Preferences, you can now be notified whenever someone adds to or edits the help pages. Each night, just after midnight, AQ will check for additions and edits to the help pages and send you an AQ mail of the changes.

Want to help out on Atlas Quest? Sign up for this notification option! Answer new questions that people add, check that nobody is vandalizing the help pages, fix typos, add missing information, or whatever else needs to be done. Do you see the same questions being asked over and over again on the message boards? Add it to the help pages!

There's also a Wiki Help board, to discuss questions about the help pages or the information in it. Mark it as a favorite if you'd like to be informed about things that are happening in the help! =)

Updated Tags

Red tag, blue tag, green tag... what do they mean? They basically represent anything you want them to represent, and I've probably heard a hundred different ways people have chosen to use their tags. The biggest problem in using them, however, is remember what one uses each tag color for!

Now, if you check out your Miscellaneous Preferences, you'll find an option to set the tag names to a more useful reminder than the color of the tag. You can label them north, south, east, or west. You can label them DNF, or with the name of the event you plan to find them at. Whatever reminds you of what the purpose of each color tag is.

Then, wherever the tag names are provided as options (such as on the Advanced Search page), you'll see the name you gave the tag rather than the color of the tag. Search results that show a box that has been tagged--you'll still see the same little stars as before, but if you hover your mouse cursor over the star, it'll show the name you gave it as a tooltip.

On a related note, back on that Advanced Search page, you'll find options to "and" or "or" tags. These only apply if you select more than one tag for your search. Let's say, for instance, you select the blue and red tag colors. You can have the search results return all boxes that have the blue and red tag, or all boxes that have the blue or red tag. It'll default to or, just as it's always been, but you do now have the option of an and search which didn't exist before.

Happy trails!

-- Ryan

Reducing the Clutter

One of the most common, ongoing complaints I get about Atlas Quest is the cluttering of search results. Old, abandoned boxes that are out of date, boxes that are known (or at least strongly suspected) of being missing, but still showing up in search results. Over the years, I've made a few stabs at the problem such as fixing listings manually that come to my attention.

Then there was the period when I went through a whole series of methods of dealing with abandoned listings. First I had set up the site so others could automatically adopt them if the owner hadn't logged in for a year, but then I'd get irate e-mails from the occasional person who'd come back about their boxes being set out for adoption. Then I created an "abandoned" status so people could see at a glance that the box might have issues and the listing may not be up-to-date, but then I kept getting requests from folks asking to adopt them (which I had stopped allowing). Seems like no matter what I did with those abandoned listings (either because the owner no longer logs into Atlas Quest at all or because the owner just doesn't update the status of their boxes when they are known to go missing), someone would be up in arms about it. And yet, nobody likes those listings.

As Atlas Quest ages, it's a problem that continues to grow worse and worse.

So once again, I'm taking another stab at the problem. =) Now, if you head on over to the Advanced Search page, you'll find a few new options. Near the bottom of the page, just above the options to hide your plants, finds, and attempted boxes, there are three new options. Let me tell you about each of them....

Hide Abandoned Boxes

This option removes from the search results any box whose owner has not logged into Atlas Quest for at least six full months. The boxes may be perfectly viable, but if it isn't, there's probably nothing in the listings that would let you know. If you have trouble finding a box, sending an e-mail off to the owner probably won't get you any results. So a lot of people would just as soon not look for such boxes.

Technically, I should point out, it's actually only hiding abandoned listings on Atlas Quest--the owner may very well be maintaining their boxes and simply be regular members of letterboxing.org. (It happens quite often, in fact.) But as far as AQ can determine, the owner simply isn't around maintaining their listings on Atlas Quest. The fact that their boxes are also abandoned is just an assumption.

There are approximately 53,000 active boxes listed on Atlas Quest, and this search option would knock out about 4,000 of them from the search results. To insure your own boxes don't get "knocked out," just make sure you've logged into AQ at least once every six months. Additionally, I've decided to enable this option as a default for most traditional box searches.

Hide Strikeouts

You probably don't know what a 'strikeout' is, since I just made it up last night. =) It's what happens when you look for the box but then fail to find it. You've struck out! Some people will go so far as to record their attempt on Atlas Quest, and if you look at the history of attempts on the box, you might see a long list of failed attempts. (One particular box listing has 62 consecutive attempts on it!) Does it mean the box is missing? Not necessarily. It might mean that the box is really, really tough to find. But if there are several consecutive attempts on a box, more often than not, it's usually missing. And most people do not enjoy trying to find boxes that are likely missing.

So I took the baseball analogy here. Three strikes, and you're out! Checking this option will remove from the search results any box where the last three entries on the find report are all attempts. Setting your preferences to hide attempts does not make your boxes immune, either. If there are a lot of attempts on your box, you can't "trick" people into looking for a box that they don't want to find by hiding your attempts.

If you like a challenge, you'll want to keep those strikeouts in your search results. Since most people don't, I'm also making the default for most searches to not include strikeouts.

What if one of your boxes has three (or more) attempts but it really is active and still can be found? That's part of what maintaining your listings is about. If the box is still there, you can record a "find" on your own box and reset the strikeout counter back to zero. Everyone has the power to reset the counter to zero, and if the attempts are bogus, part of maintaining your listing is to let everyone know it.

Only 865 of the 53,000 active boxes on Atlas Quest have "struck out" as of today. (I haven't run the numbers because the database query starts getting a heck of a lot more complicated, but I suspect the great majority of these would also be from abandoned listings.)

Hide Old Finds

Many folks want some reassurance that a box is still there by checking the last found date of the box. If the box was found within the past week, the theory goes, it's much more likely to still be there than a box that was last found a year ago.

Of all the theories of reducing cluttered search results, this is the most dubious one, in my humble opinion. I know a lot of people out there subscribe to the theory, and I'm willing to help you out by giving you an option to remove from the search results any box that hasn't been found within the last six months (that's what this option does), but it is not enabled by default.

I have a lot of boxes I've planted on long hikes, and they often times don't get any finders for years at a time. I've planted boxes in Africa and Central America which rarely get any visitors, even though--so far as I know--the boxes are still alive and well. And I've planted boxes that have such cryptic and difficult clues, that few people have ever solved them. There are many legitimate reasons a box may not have any recent finds on it, so I while I'll give you the power to remove such boxes from the search results, I won't make it a default.

For those of you who do have such boxes and are worried someone might skip over it due to it having no recent finders, you can "push up" the last found date by recording a find on the box yourself. Since this option isn't a default, however, I don't think it's really worth the effort. I don't intend to record finds on all of my rarely found boxes just to update the last found date.

For a box that has no finders (yet!), the plant date is assumed to be the "last found" date. It's the last date that AQ knows somebody was at the box and can verify its existence on that date.

A whopping 31,492 boxes of the 53,000 active listings would be cut out of one's search results if you used this option. Which, IMHO, just goes to show how incredibly unreliable using the last found date is in determining if a box is still viable. But it's an option for those who want to make use of it.

Out of curiosity, I tried extending the cutoff for "recently found boxes" to one year, and that would have cut out 25,606 boxes. Extending it to two years would have cut out 12,995 boxes. It doesn't really seem to matter what the cut-off time is.... relying on the last found date would cut out a LOT of viable boxes from your search results.

So there you have it! Hope you enjoy the new options, and I hope it unclutters your search results a bit. =)

The First "Big" Update....

Maybe it's because I'm officially a dork (or geek? I'm not really sure what the difference is?), but in the last five months, I've really missed coding. The stuff that requires me to open the hood on Atlas Quest, replace parts, shake up the database, and makes me think--how can I get the system to do something it may not want to do. An idea is great, but figuring out how to make them work can be a lot of fun.

The very first changes I made to AQ since getting back were largely cosmetic in nature. Fast and easy to implement. But I really wanted to get into the guts, and now I've done so. =)

The changes aren't obvious, and most of you probably won't even care about them, but they were things that bothered me for a long time. If you go to the Advanced Search page, that's where you'll see the results of my mucking around. In particular, the stamp types and the hike types sections.

They used to be radio buttons. Now they are checkboxes. Before, you could only search one category at a time: For instance, if you wanted a list of all boxes that required a hike of three miles or more, you had to either accept "all" lengths, or you had to run two searches--one for "treks" and one for "expeditions." Now you can specifically pick both types at once. You could even throw in the boxes of "unknown lengths" in case some of those might be longer hikes as well--or not, if you think that would likely include too many false positives.

I usually skip looking for any box marked as a store-bought stamp, but I don't mind looking for the occasional custom-made stamp along with the hand-carved stamps I usually find, and now I can run a search that lets me hide those store-boughts that I'm not interested in while keeping all of the other boxes in my search results. Awesome! =)

I've also turned a couple of  "admin only" features into features that everyone can now use. Once again, you can see that on the Advanced Search page--it's now possible to search for boxes that have blue diamonds and/or planter's choice icons on them. I originally used them to help test me test various algorithms. I'd tweak an algorithm, run it, then see what sorts of boxes were being assigned the blue diamonds by running a "blue diamond search." I've actually had that as an option available for admins since those features were created, but admittedly kept them "admin only" options thinking they'd likely be too controversial. They probably still are, but I don't really care anymore either. =)

When you're wandering through the woods wondering where your next good water source is and if you have enough food to get to the next trail town, you start thinking about the problems in the "real world" and start thinking, "Who the hell cares one way or another about blue diamonds? There are far more important things for me to worry about. If someone doesn't like those being options, they can jump in a frozen lake. It'll give them something else to worry about--problems that really matter."

So I've made those options available to all now. Yes, if you run searches that return only blue diamond boxes, you'll certainly miss some great boxes that don't have them. Yes, if you run searches that return only planter choice boxes, you'll also miss some great boxes that don't have them. But really, is there any method that can guarantee you'll get a list of every great box in an area without actually finding every box in the area yourself? Recommendations from friends are incomplete unless they've found every box in an area. And they might skew their results based on their own personal preferences. Yadda, yadda, yadda.

So I'll say it now--yes, you will miss some awesome boxes if you just look for boxes that have blue diamonds. But I'll say two things about that: One, who cares? I don't. That's your loss. And two, it's not possible to create a definitive list of "must find" boxes with any method. The only way to guarantee you'll find every fantastic box in an area is to actually go out and find every box in the area. And when we're traveling, that's rarely a realistic option. A blue diamond list may not be perfect, but neither is any other list. At least it gives you a starting point, though.

And finally one other tweak--many moons ago, when I was testing code that was specific to where clues were hosted, I'd find it useful to search based on where clues were hosted as test cases. So I made an admin-only option that let me search based on if a clue were hosted on Atlas Quest, LbNA, or some other remote website. It would even show an icon in the list of attributes to let me know where the clue came from. (Those icons would always show up in my printouts of clues, and I always wondered if anyone noticed the "extra" icons that would show up in my printouts, but if anyone did, they never said anything about it.) It was mostly a feature I used for testing. The only practical use I could think of that you all might use it for would be to run a search that suppressed LbNA-hosted clues if you were planning to check for clues on that website anyway. It would reduce the redundancy of seeing those particular boxes on both sites. But it would likely "look bad" to provide an option that would let people suppress LbNA-hosted clues on searches here, even if the point was to encourage people to get a full list of LbNA-hosted clues at LbNA.

I've also found that I rarely ended up using that search option--if I needed to find a box with clues hosted on LbNA, for instance, I'd just run a simple search then scroll down the attribute list looking for one marked appropriately. Seemed a bit laborious to actually run an advanced search.

So I took that option out from the search options--makes the code shorter and easier--but I left the icons intact and they're now available for everyone to see. If you run a search, it'll show an icon indicating where the clue is hosted--Atlas Quest, LbNA, or "some other remotely hosted clue"--before you click or even hover your mouse cursor over the link. Then I added additional ones for kicks--there are now icons for clues hosted on the geocaching.com website and for those hosted on Blogger. Again, the ability to search based on where a clue is hosted is not an option, but you can see at a glance where the clue is hosted.

Which can be useful for a couple of reasons. You might see that a clue is hosted on geocaching.com and might naturally think it's a hybrid box--and perhaps not one you'd like to get.

Another possible use: AQ often uses cached clues for some features like the ability to print several clues at once--but this often doesn't work well with Blogger-hosted clues (which are often photo clues, and photos aren't cached) or other remotely-hosted clues. If you see one of those in your list, it might be a good idea to take a special look at the clue before printing a cached version of it. (I knowingly walked passed one letterbox on the PCT when the clue stated to find the location where the photo was taken... but my clue didn't have the photo attached! Argh!)

And, just because I could, I added one special icon for any clue that I've hosted on my Ryan's a Total Goober website. Which right now, amounts to just one clue. I usually host my clues on AQ, but one particular clue I needed to do some advanced HTML that wasn't permitted on AQ. It's not really useful in this particular case, but it's one of the perks of running your own website. =)

If you run a search for New York, NY, for instance (at least with my search results), you'll see icons representing AQ-hosted clues, LbNA-hosted clues, two Blogger-hosted clues, and four "other remote clues." Just click on the icon to open up the clue page.

So there you have it.... some of the updates I just installed about an hour ago. Enjoy! =) I mucked with the code. I mucked with the database. I probably broke some stuff and don't even know it yet. If you see any problems, do let me know!

And aren't you'll glad I'm back? =)

-- Ryan

It's that time of year again....

What time of year is that, you ask? Calendars! Actually, I'm a little late this year. I've been... preoccupied with other issues. ;o) But now that that little project is over and I'm back online, it's time to make the 2011 letterboxing calendar. It's not too late to submit your photos for selection! Get your photos submitted ASAP, however. I plan to select the final winners within the next few days and start putting the calendar together! I don't have a specific cut-off date or time in mind, but it'll be soon.

Project X: Letterboxing Calendar
Sample the 2010 Calendars
Upload Your Submissions

Clues on the Trail

As most of you know, I'm currently thru-hiking the Pacific Crest Trail. This activity often holds one special challenge for me--getting clues. I can check e-mail, but I can't necessarily get on the Internet. I really needed a way to get clues to me via e-mail.

So, while Amanda is here to slackpack me, I've been working on a new feature late into the nights. Admittedly, it's largely for selfish purposes, but for those of you who also have e-mailing ability on your cell phone but don't necessarily have access to Atlas Quest on the Internet--or maybe you don't have an easy way to store clues on your device--this feature might be very useful for you. =)

To make it work, send an e-mail to 'boxes' at 'atlasquest.com' including the location you want letterbox clues for as the subject. It's just a normal run-of-the-mill location-based search, so anything that works for a location based search works here--cities, intersections, addresses, zip codes, and so forth. Leave the body of the message blank. (Or you can write stuff in it, but AQ will ignore anything you write.)

After a minute or two, you should get a reply with the clues for that location. If the e-mail address is one that is registered with Atlas Quest, it will also strip out clues for boxes you've planted and already found.

You have mail! =)

Is it art? Or graffiti?

Yesterday evening, I went on my normal Alki walk. It was a nice night out. Wonderful views of Puget Sound. And about halfway along my walk, I found two characters "decorating" a truck. I've seen vehicles hit with TP and stuff written on the windows before, but at a glance, I could tell this was something special. The two guys had an enormous roll of plastic wrap and were just starting to wrap the car. And looking into the cab of the truck, I could see it filled with packing peanuts. Right up to the windows.

That was evil. But when I took a closer look, I was even more impressed. They lined the inside of everything in the truck with aluminum foil. The steering wheel, the seats, the head rests on the seats, the review mirror--everything covered with aluminum foil. How long this must have taken I can't imagine. The packing peanuts was pure evil. Whoever owns that truck will likely be finding those for months on end.

And I decided, I needed photos. This was a work of art. This is something I would have normally guessed was Wassa's work, except I know Wassa, and neither of the two men doing this was him. I asked what unspeakable crime the owner of the truck committed, and was told he was getting married. The fool. *shaking head*

I wanted photos, but I didn't have my camera on me. Curses! I walked home.

This Alki walk is a good five or so miles in length, and after getting home, I sat around for a couple of hours getting some work done and letting my feet rest. But I still wanted photos, and I didn't know when the owner of that truck would be back and start the cleanup. I needed to get pictures that night. So I grabbed a camera, and at 2:00 in the morning, I went off to take photo.

These are the best photos that came out. The flash was blinding, and the natural light at 3:00 in the morning was less than ideal. However, you can see the packing peanuts in the vehicle, half covering the steering wheel (which itself was wrapped with aluminum foil). I walked back home and went to sleep.

I wanted to see if I could get better photos, however, so I did my walk a third time in the light of day the next morning, hoping none of the cleanup had started. And YES! It was still there, completely untouched!

I'm not really sure the photos from the light of day were any better. The glare of the sun caused its own problems, and I actually had to touch up these photos in my photo-editing software to make them look this good!

I really like the aluminum foil trim on the tires of the truck. That just seems classy to me.

Then I posted a note on the car saying, "The letterbox can be found in the peanuts." No idea if the owner will understand that message, but the mystery will certainly intrigue him. =)

Virtuals Revisited

When I first saw virtuals, I didn't really get the appeal. Until one.... there was one virtual that I positively thrilled myself solving. It's simple--practically mindless, in fact--but I absolutely loved it. It's called the Peatbank. If you've never been interested in virtuals, it's at least worth keeping your mind open for this one. It's different. I'm not sure who created it, except that it was an Englishman (or woman), and it was rather unfortunate this type of virtual didn't get 'exported' into the United States like their real letterboxes had been. This virtual made the hunt for a virtual box as much like the real thing as possible on thing contraption we call the Internet.

So far as I know, only one attempt was ever done to recreate the spirit of that original Dartmoor virtual box, Lone R's Northern Village. It was a supremely satisfying change of pace of the usual virtuals being posted and I hoped it would inspire others, but apparently... it didn't. *shrug*

But that's the kind of virtual I actually get excited about, and finally, I set up a system that makes it a heck of a lot easier for me to list that type of virtual myself. For those of you paying attention to recent virtuals, you'll have noticed a positive blizzard of these types of boxes. I probably created more in the last few days than have ever existed, and each one I listed tested some of the code behind it. Tweak some more, listed another one, tweak some more, list another one.

It started with The Seychelles, a place Amanda has always wanted to visit. But I also imagined ways to letterbox virtually that we could never do in real life, such as in space or underwater, or even find a true "micro" box. I have some other ideas for virtuals I'd like to create, but I'll save those as surprises.

The code for listing these types of virtuals seems pretty solid now, so the feature has been opened for anyone and everyone who would like to give their hand at it. Seems like a lot of you have been enjoying these virtuals I've listed over the last few days, but I'd like to enjoy solving a few that others have listed! The process for creating them is still considerably more complicated than the usual state of using passkeys, but it does take out a lot of grunt work that would have been required before which is why the most time consuming part to create these virtuals was carving the stamp--not setting up the HTML which used to be the biggest bottleneck.

Look for a lot more of these in the future! If you're interested in solving these, be sure to join the Virtuals group. Otherwise, the virtual functionality is largely hidden.

Did you miss the mustache during all the shenanigans?

With all the shenanigans going on lately, from Apollo Quest and random themes to alleged marriages going on and suspect dentist visits (okay, the dentist visit was real), real development for Atlas Quest has not come to a completely stand still. It just seems that way. And, so far, it seems like nobody has noticed on a couple of the newest features.

First, there's that suspicious mustache icon. I added this over a week ago, and at least a few people have noticed it since I see it used in about a dozen entries. But I'm a little surprised that nobody has yet to comment on it on the message boards. This icon can be applied to any event box that's Hidden In Plain Sight (HIPS), if you want to give people a head's up to keep their eyes open. Kuku and Wassa (and Wassa friends) were the inspiration for this icon. Kuku e-mailed me a question about how to list a HIPS box, and technically speaking, there wasn't any way to list them, but it seemed like it could be a useful icon for event boxes.

I wasn't sure what kind of icon could represent a HIPS box, however, so I scratched my head a bit thinking about all those sneaky HIPS boxes I've found in the past--hidden in fake cans, hollowed out books, in otherwise empty donut boxes, and such. Leave something unusual on a picnic table at an event--such as a rock. A solid piece of granite. Just put it on a picnic table and watch what happens. Admire the dozens of people that will pick up the rock, look under the rock, knock the rock around. They're convinced it's a hidden event stamp, and they'll spend ten minutes trying to figure out The Secret of the Rock. Even when there is no secret! That's how powerful these HIPS boxes are. They turn sane people into those crazy people you'll cross the street to avoid.

Of course, when I start thinking about sneaky and conniving, I start remembering the fun from the Spy vs. Spy event. And when I start thinking about that event, I start remember the ridiculous fake mustaches Wassa's team wore. And I thought, "Ha-ha!" THAT can be the icon for a HIPS box! Wassa's mustache! And thus, he unwittingly became the inspiration for the icon. Remember that the next time you see the icon. ;o)

In a completely unrelated update, there's yet another new search option I call the Linear Path Search, which is a really ugly name to describe a search along the straight line from Point A to Point B. It's a lot like the Trip Planner search that allows you to search for all boxes within a specified distance of a specific route, though in this case, you get to the pick the starting and ending points for anywhere on Earth. And, it'll only work with straight lines. So if you're traveling along an Interstate, you're still probably better off running a Trip Planner search. If you're traveling off the beaten path, however, or live in Canada or Europe where there is no trip planner support (as of yet, at least), the linear path search can recreate a lot of that functionality.

Take this example of a 5-mile wide search from Sacramento to Seattle. (Technically speaking, the search is for all boxes within 5 miles of the line from Sacramento to Seattle, so it's actuall 10-miles wide--5 miles for each side of the line.) Each box shows how far down that line the box is located, and how far off from the line the box is located. And check out the mapped results--pretty slick-looking, don't you think?

For long distances such as this, it's probably not that helpful since most roads won't be anywhere near straight enough to follow a straight-line route, but broken into shorter segments, it could prove to be a very useful search. Any point on Earth can be mapped--addresses, cities, zip codes, latitude and longitude coordinates, and more. Anything you can search for using a location-based search will work as points for the linear path search.

Happy trails!

Nevermind....

That whole thing about changing the name of Atlas Quest? The deal fell through, so nevermind about all that. We'll be keeping the domain atlasquest.com until a legitimate offer comes along. *rolling eyes* My bad!