Changes

From Wazeopedia

User:PesachZ/Scripts/URComments

9,155 bytes added, 4 years ago
Created page with "<noinclude>{{:Scripts/Script subpage}}</noinclude> {{#ifeq:{{{summary|}}}|yes|<!-- ## DO NOT EDIT ABOVE THIS LINE ## PLACE ALL SCRIPT CONTENT BELOW THIS LINE ## --><!-- VERY..."
<noinclude>{{:Scripts/Script subpage}}</noinclude>
{{#ifeq:{{{summary|}}}|yes|<!--
## DO NOT EDIT ABOVE THIS LINE
## PLACE ALL SCRIPT CONTENT BELOW THIS LINE
## --><!-- VERY BRIEF SCRIPT SUMMARY GOES BELOW THIS LINE
## --------------------------------------------------------->
[[File:Solved-with-comments-purple2.png|50px|right]]
URComments helps streamline the process of responding to Update Requests. It generates comments based on UR type and days since last response, or you can manually choose from a list of comments. The comments are adjustable before sending. Several languages are available, if yours is not available, you can make your own custom list.
<!--##----------------------------------------------------
## VERY BRIEF SCRIPT SUMMARY GOES ABOVE THIS LINE -->|<br><!--
## FULL SCRIPT DESCRIPTION GOES BELOW THIS LINE
##------------------------------------------------------->

by {{Username|Rickzabel|RickZabel}}

On this page, you will find a brief overview of the features of the WME URComments script. Within WME, holding the mouse over any of the items will show tool tips describing the function or displaying the text to be used. For an extensive description, please view the [[#Illustrated_slideshow|illustrated slideshow]].


==== Updates ====
This script has an auto-update feature which automatically download and install the up-to-date version upon release.

==== Features ====
[[File:WME URComments UR pill.PNG|right]]
WME URComments displays the URs in your screen with a brief indication of its status; amount of comments, amount of days since last comment, and who the commenter is. White and blue pills indicate URs that you currently handle. You can find an elaborate description of the pills in the [[#Illustrated_slideshow|illustrated slideshow]].<br />

This script adds another tab to the left side panel in WME. There are four main elements, the header and three sub tabs. We will explain each of the elements below.

====== Header ======
[[File:WME URComments tab1.PNG|right]]
# '''UR Comments Version Number''': Tampermonkey and Greasemonkey are not always reliable at fetching updates, so once-in-a-while it is a good idea to check your version number against the version listed on greasyfork.
# '''Zoom Out 0 & Close UR''': Zooms all the way out and closes the UR window.
# '''Zoom Out 2 & Close UR''': Zooms out to level 2
# '''Zoom Out 3 & Close UR''': Zooms out to level 3. This is where you can find most of the toolbox highlighting works.
# [[File:WME URComments reloadbutton.PNG]] Map reload button: Reloads the map without having to go into Waze's layers menu
# '''55''' or any other number: amount of active URs (maybe hidden by filters) in your display

===== Comments =====
WME URComments generates comments based on UR report type. You can have them auto-inserted in the text window of the UR, or choose from a list of other comments. You can adjust the comments before sending, depending on the presets. To make your own custom list, view the [[#Tutorial_to_Customize_URComments|tutorial]].
<br />

[[File:WME URComments Comments small.PNG |right]]<br />

The comments in the list are color coded, black, orange, green, and red. They all generate a standard text that auto-inserts in the comment window. If you enable the setting "Auto click open, solved, not identified", the script will also set the status of the UR:
*'''Black''' comments set the UR Status to "Open"
*<span style="color:#E68A00">Orange</span> comments set the UR Status to "Not Identified"
*<span style="color:#008F00">Green</span> comments set the UR Status to "Solved"
*<span style="color:#CC0000">Red</span> comments have errors in the script; they will still generate the comment text and then set the UR Status to "Open"

Before actually sending your commment, make sure you understand the report and adjust the text accordingly!

===== Filters =====
[[File:WME URComments filters1.PNG|left]]
<br /><br /><br /><br />

You can set several kinds of filters for URs to display. Hover your mouse over the items will show tool tips describing their function.
<br /><br /><br /><br /><br /><br /><br />

Also, you can set the amount of days after you wish to send a reminder message, and the amount of days after you would like to close a message. <br />


====== Integration with URO+ ======
<!--URO+ shortcuts are deleted from the script -->
From version 1.1.0 on, you can easily use URComments without [[Scripts#UR_Overview_Plus_.28URO.2B.29|URO+]] installed, since URComments has it's own filter settings. For those using URO+, URComments works smoothly together. However, if you use URO+ filters, the filters of URComments will be disabled. To enable them, simply check ''Enable URComments UR filtering''. You may need to disable URO+ filters first.<br /><br />
<!--Previous text: From version 1.1.0 on, you can easily use URComments without URO+ installed, since URComments has it's own filter settings. However, if you use URO+ filters, the filters of URComments will be disabled. To enable them, simply click URO+ Clear UR Filters, and subsequently check Enable URComments UR filtering (from the first list). -->

===== Settings =====
[[File:WME_URComments_settings.PNG|right]]
In the settings, you define how URComments works for you. To make yourself acquintainted, it is recommended to check all settings from the first list, except the 8th and the last two. Holding the mouse over any of the items will show tool tips describing the function.

From the Comment List Drop down menu, choose which list you want to use. The available files are listed under [[#Installation|Installation]]. To make your own list, use the Custom List and view the tutorial. If you need support, you can find [[#Assistance|assistance]] in the forum.

Some advanced settings are at the bottom of this tab. Make yourself acquainted with this script before you change the settings and use them with care, especially the ''Auto send reminders'' option.

==== Illustrated slideshow ====

===== Presentation of WME URComments =====

{{#widget:Iframe
|url=https://docs.google.com/presentation/d/1zwdKAejRbnkUll5YBfFNrlI2I3Owmb5XDIbRAf47TVU/embed?start=false&loop=false&delayms=30000
|border=0
|width=700
|height=423
}}<br />

You can view this presentation [http://docs.google.com/presentation/d/1zwdKAejRbnkUll5YBfFNrlI2I3Owmb5XDIbRAf47TVU/present#slide=id.p full screen], or open the [http://goo.gl/kLg7e2 slide show] in google drive.

===== Tutorial to Customize URComments =====
Especially for the use of URComments in other languages, there is a Custom List that you can use to make a list of comments in your own language. In this tutorial you will find an elaborate explanation on how to do that:
<br />
(to be added)

<!-- PLACE ALL SCRIPT DESCRIPTIONS ABOVE THIS LINE. DOWNLOAD LINKS GO BELOW -->

↓ {{U|'''DOWNLOAD'''}} ↓
WME URComment is available on the following browsers:
* Chrome: [http://greasyfork.org/en/scripts/5592-wme-ur-comments-stable WME UR Comments] (update link) via [http://tampermonkey.net/ ''TamperMonkey'']
* Firefox: [http://greasyfork.org/en/scripts/5592-wme-ur-comments-stable WME UR Comments] (update link) via [http://addons.mozilla.org/en-US/firefox/addon/greasemonkey/ ''Greasemonkey'']


To use other languages or make your own custom list, you need to install one of the following scripts in addition:<br />
* [http://greasyfork.org/en/scripts/6236-wme-ur-comments-custom-list/ Custom List] Install and edit this file if you wish to customize comments. There is a [[#Tutorial_to_Customize_URComments|tutorial]] at the bottom of this page to guide you.
* International List: a shorter and slightly simpler version of the Comment Team list. This list is handy for base map editing and starting communities.

* [http://greasyfork.org/en/scripts/7292-wme-ur-comments-brazilianportuguese-list Brazilian Portuguese Comments], maintained by {{Username|Murilo-Carvalho}}
* [http://greasyfork.org/nl/scripts/7276-wme-ur-comments-dutch-list Dutch Comments], maintained by {{Username|moweez}}
* [http://greasyfork.org/en/scripts/8682-wme-urcomments-hebrew-list Israeli Hebrew Comments ] maintained by {{Username|crayzee}}
* [http://greasyfork.org/en/scripts/7279-wme-ur-comments-spanish-list Spanish Comments], maintained by {{Username|carloslaso}}

<!-- do personal user's scripts need to be published on the wiki page?
'''User's Lists'''
[http://greasyfork.org/en/scripts/7272-wme-ur-comments-pesachz-list PesachZ's Comments ''on GreasyFork.org''] maintained by PesachZ.''
-->

{{Clear}}
==== Assistance ====
Should you require any assistance on this script, or want to propose new features, please post a message in the following forum thread: [http://www.waze.com/forum/viewtopic.php?f=819&t=122776 UrComments] (in English).

{{mbox
| type = forum
| style = background: #cadceb;
| text = Should you require any assistance on this script, or want to propose new features, please post a message in the following forum thread: [http://www.waze.com/forum/viewtopic.php?f=819&t=122776 UrComments] (in English).}}

<!-- PLACE CATEGORIES BELOW THIS LINE -->
<noinclude>[[Category:Script Subpage]]</noinclude>}}