/app/views/integrations/index.en.html.erb
Ruby HTML | 129 lines | 113 code | 16 blank | 0 comment | 15 complexity | 175a3ba93ae39e4d36a923f5d33c2f70 MD5 | raw file
- <% has_contexts = !current_user.contexts.empty? -%>
- <h1>Integrations</h1>
- <p>Tracks can be integrated with a number of other tools...
- whatever it takes to help you get things done!
- This page has information on setting up some of these.
- Not all of these are applicable to all platforms, and some require more
- technical knowledge than others.
- See also <%= link_to "developer documentation for Tracks' REST API", url_for(:action => 'rest_api') %>.</p>
- <br/><p>Contents:</p>
- <ul>
- <li><a href="#applescript1-section">Add an Action with Applescript</a></li>
- <li><a href="#applescript2-section">Add an Action with Applescript based on the currently selected Email in Mail.app</a></li>
- <li><a href="#quicksilver-applescript-section">Add Actions with Quicksilver and Applescript</a></li>
- <li><a href="#email-cron-section">Automatically Email Yourself Upcoming Actions</a></li>
- <li><a href="#message_gateway">Integrate Tracks with an email server to be able to send an action through email to Tracks</a></li>
- <li><a href="#google_gadget">Add Tracks as a Google Gmail gadget</a></li>
- </ul><br/>
- <p>Do you have one of your own to add?
- <a href="http://www.getontracks.org/forums/viewforum/10/" title="Tracks | Tips and Tricks">Tell us about
- it in our Tips and Tricks forum</a> and we may include it on this page in a future versions of Tracks.
- </p>
- <a name="applescript1-section"> </a>
- <h2>Add an Action with Applescript</h2>
- <p>This is a simple script that pops up a dialog box asking for a description, and then sends that to Tracks with a hard-coded context.</p>
- <% if has_contexts -%>
- <ol>
- <li>Choose the context you want to add actions to: <select name="applescript1-contexts" id="applescript1-contexts"><%= options_from_collection_for_select(current_user.contexts, "id", "name", current_user.contexts.first.id) %></select>
- </li>
- <li>Copy the Applescript below to the clipboard.<br />
- <textarea id="applescript1" name="applescript1" rows="15"><%= render :partial => 'applescript1', :locals => { :context => current_user.contexts.first } %></textarea>
- </li>
- <li>Open Script Editor and paste the script into a new document.</li>
- <li>Compile and save the script. Run it as necessary.</li>
- </ol>
- <% else %>
- <br/><p id="no_context_msg"><i>You do not have any context yet. The script will be available after you add your first context</i></p>
- <% end %>
- <a name="applescript2-section"> </a>
- <h2>Add an Action with Applescript based on the currently selected Email in Mail.app</h2>
- <p>This script takes the sender and subject of the selected email(s) in Mail and creates a new action for each one, with the description, "Email [sender] about [subject]". The description gets truncated to 100 characters (the validation limit for the field) if it is longer than that. It also has Growl notifications if you have Growl installed.</p>
- <% if has_contexts -%>
- <ol>
- <li>Choose the context you want to add actions to: <select name="applescript2-contexts" id="applescript2-contexts"><%= options_from_collection_for_select(current_user.contexts, "id", "name", current_user.contexts.first.id) %></select>
- </li>
- <li>Copy the Applescript below to the clipboard.<br />
- <textarea id="applescript2" name="applescript2" rows="15"><%= render :partial => 'applescript2', :locals => { :context => current_user.contexts.first } %></textarea>
- </li>
- <li>Open Script Editor and paste the script into a new document.</li>
- <li>Compile and save the script to the ~/Library/Scriipts/Mail Scripts directory.</li>
- <li>For more information on using AppleScript with Mail.app, see <a href="http://www.apple.com/applescript/mail/" title="Scriptable Applications: Mail">this overview</a>.</li>
- </ol>
- <% else %>
- <br/><p><i>You do not have any context yet. The script will be available after you add your first context</i></p>
- <% end %>
- <a name="quicksilver-applescript-section"></a>
- <h2>Add Actions with Quicksilver and Applescript</h2>
- <p>This integration will allow you to add actions to Tracks via <a href="http://quicksilver.blacktree.com/">Quicksilver</a>.</p>
- <% if has_contexts -%>
- <ol>
- <li>Choose the context you want to add actions to: <select name="quicksilver-contexts" id="quicksilver-contexts"><%= options_from_collection_for_select(current_user.contexts, "id", "name", current_user.contexts.first.id) %></select>
- </li>
- <li>Copy the Applescript below to the clipboard.<br />
- <textarea id="quicksilver" name="quicksilver" rows="15"><%= render :partial => 'quicksilver_applescript', :locals => { :context => current_user.contexts.first } %></textarea>
- </li>
- <li>Open Script Editor and paste the script into a new document.</li>
- <li>Compile and save the script as "Add to Tracks.scpt" in ~/Library/Application Support/Quicksilver/Actions/ (you may need to create the Actions directory)</li>
- <li>Restart Quicksilver</li>
- <li>Activate Quicksilver (Ctrl+Space by default)</li>
- <li>Press "." to put quicksilver into text mode</li>
- <li>Type the description of the next action you want to add</li>
- <li>Press tab to switch to the action pane.</li>
- <li>By typing or scrolling, choose the "Add to Tracks" action.</li>
- </ol>
- <% else %>
- <br/><p><i>You do not have any context yet. The script will be available after you add your first context</i></p>
- <% end %>
- <a name="email-cron-section"> </a>
- <h2>Automatically Email Yourself Upcoming Actions</h2>
- <p>If you enter the following entry to your crontab, you will receive email every day around 5 AM with a list of the upcoming actions which are due within the next 7 days.</p>
- <textarea id="cron" name="cron">0 5 * * * /usr/bin/curl -0 "<%= home_url %>todos.txt?due=6&token=<%= current_user.token %>" | /usr/bin/mail -e -s 'Tracks actions due in the next 7 days' youremail@yourdomain.com</textarea>
- <p>You can of course use other text <%= link_to 'feeds provided by Tracks', feeds_path %> -- why not email a list of next actions in a particular project to a group of colleagues who are working on the project?</p>
- <a name="message_gateway"> </a>
- <h2>Integrated email/SMS receiver</h2>
- <p>
- If Tracks is running on the same server as your mail server, you can use the integrated mail handler built into tracks. Steps to set it up:
- </p>
- <ul>
- <li>Go to <%= link_to t('layouts.navigation.preferences'), preferences_url %> and
- set your "<%= Preference.human_attribute_name('sms_email') %>" and
- "<%= Preference.human_attribute_name('sms_context') %>" for todos sent in
- via email (which could come from an SMS message)</li>
- <li>In sendmail/qmail/postfix/whatever, set up an email address
- alias to pipe messages to <pre>/PATH/TO/RUBY/ruby /PATH/TO/TRACKS/script/runner -e production 'MessageGateway.receive(STDIN.read)'</pre></li>
- <li>Send an email to your newly configured address!</li>
- </ul>
- <p>You can also use the Rich Todo API to send in tasks like "do laundry @ Home"
- or "Call Bill > project X". The subject of the message will fill description,
- context, and project, while the body will populate the tasks's note.
- </p>
- <a name="google_gadget"> </a>
- <h2>Add Tracks as a Google Gmail gadget</h2>
- <p>
- You can now manage your projects/actions inside Gmail using Tracks Gmail Gadget.
- Add Tracks Gmail gadget to the sidebar of Gmail and track your next actions
- or add new action without explicitly open new browser tab for Tracks. Steps to set it up:
- </p>
- <ul>
- <li>Sign in to Gmail and click Settings in the top right of your Gmail page. In Gmail setting page, click Labs tab</li>
- <li>Enable the "Add any gadget by URL" feature. You will find it at bottom of the list. Select Enable radio button and click Save Changes button.</li>
- <li>Now you can see Gadgets tab added to Gmail Settings. Go to the Gadgets tab</li>
- <li>Paste following link to the Add a gadget by its URL: and then click Add button:<br/>
- <pre><%= integrations_url + "/google_gadget" %></pre></li>
- </ul>