Text Templates

From Cachly Help Wiki
Revision as of 09:11, 28 March 2018 by ChrisDen (talk | contribs) (Defining Text Templates)
Jump to: navigation, search

Text Templates

Text templates are a powerful tool that can greatly simplify your cache logging. The general idea is that you pre-define a log message to use for various kinds of cache logs (Found it, Didn't Find It, ...). Then when you log a cache with that status, the log message is largely already written and you can add to it, modify it, or just send it as is. Let's dive deeper and see how you can use this powerful feature.

Defining Text Templates

You start by tapping More_Tab->Settings->Enable Log Type Templates so you can use them. Next you define a text template. That is done from the More_Tab->Settings and tap Text Templates. Tap the + in the title to get started.

Define Text Template

Here you do these three steps:

  • give the template a name
  • choose the log type it is to be used with (e.g. Found it, Didn't find it...)
  • enter the template message text

All the log types can have an associated text template but typically you will only have "Found it" and Didn't find it. Let's look at a template that is mostly filled out. The name has been entered already and it is to be used for Found It logs. The template text is some sentences and the *|xxxxx|* markers are places where a value is inserted at logging time. This template includes the date, the time and your current total find count. Available insertion markers can be selected by tapping the key icon.

Found It Template

When you are happy with your template, tap Save to finish up. You will see your template on the Available Templates list. If something is not right, you can swipe left and choose Edit or tap Edit at the bottom of the screen. You can delete one by swiping left or via Edit.

You can select one of your templates to be the default log action when you choose Log this cache. Being an optimist, you choose Found, of course. If you don't want a default log action, just don't tap any of them. The tap toggles the state so you can turn off the default if you happen to have it set.

If you have set up more than one template you can sort them manually by tapping "Edit" at the bottom left of the screen.

Available Text Templates

Using a Text Template

Now let's use this new template to give you a feel for how they work in practice. I've turned on Enable Log Type Templates in Settings to allow automatic entering of text for defined log types. Now suppose I have found a cache so I tap the Log This Cache on the Cache Details screen. Then I see the below screen to complete the logging.

Notice that the Log Type is automatically set to Found It and the text template for Found It logs has been filled in. If I now tap Send Now at the top, my logging is done. Of course, you could have things defaulted to Save the log as a Draft in which case you would see Save Now instead. The template inserts are not filled in until you choose to Save or Send so you can do further editing of the text if there is more you want to say.

For a power trail logging does not get much easier. Tap Log This Cache and tap Send Now or Save Now. All done.

Ready to Send Log

Other Scenarios

  • Default is Found but you didn't find it: Just tap Log Type and switch it to Didn't find it. If you had a text template for that, the text will automatically change right then to reflect that.
  • You have boilerplate text for your outing like "Caching with user1 today to get a lot of finds." If the current find deserves more messaging, just tap Message and edit the text accordingly.