Difference between revisions of "User:PesachZ/SyncScratch"

From Wazeopedia
m (Copying text of wiki page for coparison with the "Scripts" page)
m (Copying text of wiki page for coparison with the "WME Place Harmonizer" page)
Line 1: Line 1:
<!--if the section parameter is defined, do not place the visible banner, only as the code block for the top of a section-->{{GlobalMark/visible}}
+
[[File:Wmeph.png|thumb|right|250px]]
<!--
+
WME Place Harmonizer is a script originally written by {{Username|BMTG}}. WMEPH helps with all aspects of editing places except update requests. The script team is administered by {{Username|t0cableguy}}, and the lead developer is {{Username|MapOMatic}}.
#####-----#####-----#####-----#####-----#####-----#####-----#####-----#####-----
 
####    This page has been curated  ####
 
####    to be included in the new    ####
 
####    Wazeopedia - GLOBAL Wiki.  ####
 
####    Please do not make any      ####
 
####    edits on this page without  ####
 
####    PRIOR CONSENSUS in the Wiki  ####
 
####    Updates and Discussions      ####
 
####    forum thread for this page.  ####
 
####    If a specific forum thread  ####
 
####    for this page doesn't exist  ####
 
####    please start one.            ####
 
####        www.waze.com/forum/      ####
 
####        viewforum.php?f=276      ####
 
####                                ####
 
#### - - - - - - - - - - - - - - - - ####
 
####                                ####
 
####    If you are a script author,  ####
 
####    or you are a script authors' ####
 
####    representative you may add  ####
 
####    your scripts details to this ####
 
####    page. Please follow these    ####
 
####    instructions so your script  ####
 
####    can match the uniform style  ####
 
####    of the rest of the page.     ####
 
####                                ####
 
####    To add a new script section  ####
 
####    to this page please add the  ####
 
####    {{NewScript|SCRIPT TITLE}}   ####
 
####    template to this page in the ####
 
####    position where you would    ####
 
####    like the new section to be.  ####
 
####    After saving the page,       ####
 
####    expand the new section and   ####
 
####    click the link to add the    ####
 
####    script details.              ####
 
####                                ####
 
####    Your script page should not  ####
 
####    have any headers less than  ####
 
####    level 3. You should only use ####
 
####    at least level 4+ headers.   ####
 
#####-----#####-----#####-----#####-----#####-----#####-----#####-----#####-->
 
  
<languages />
+
The script validates, formats, and harmonizes the information for a selected place.  It pulls standardized info for over 1800 chains from the PNH (Place Name Harmonization) data sheets.  Places that are complete are automatically locked to the appropriate level based on category and location of the place (i.e. state/region/country rules are applied).  Banners above the place information sidebar provide feedback on what is missing or out of spec with the place region's wiki guidance.  Links to websites, search results, and PNH submission forms make working on places faster and easier.  Hours can be added by pasting info from the place’s website or using shorthand entry. An optional yet highly useful highlighting feature shows places on the map needing work.
 +
=Basic Functionality=
 +
[[File:WMEPH banner and highlights.png|thumb|center|650px]]
 +
*Color highlights and borders are placed on each place on the map according to the image above. Each type indicates a different problem, or completion level.
  
<translate><!--T:1-->
+
*When "Run Wmeph" is pressed several items appear at the top of the Place panel and provide places for you to input the relevant information. You will search accordingly and input information into each field and click add. WMEPH formats and inserts the information into the right place in the place panel. Re running the checks by pressing "Run WMEPH" will recheck the fields and lock the place when the values are all present.
The Waze community has created the following plugins/extensions/addons for use in the Waze web-based environments.  
+
See [[#Browser requirements|Browser requirements and instructions]].
+
*The script will match names to chains in the Place Name Harmonization list when matches are found.
  
<!--T:2-->
+
=Who can use it=
Please be aware that these scripts commonly require updates in order to properly work after new releases of the Waze products. While some may update automatically once their authors make changes, others may require manual updating on your part.</translate>
+
Any editor rank 2 and up, editing in USA or Canada.  (Some script options are restricted to higher ranked editors.)
  
[http://code.waze.tools/ <translate><!--T:3-->
+
=How to use=
Common Scripts Repository for Developers & End Users</translate>]
+
Select a place in WME.
  
 +
Press the “Run WMEPH” button at the top of the sidebar [http://i.imgur.com/If6XVom.png Screenshot], or press the keyboard shortcut.  The default is Alt-Shift-A; you can change this in the WMEPH preferences panel. (use a lowercase letter if you don't want the Shift key in the shortcut) 
 +
[http://i.imgur.com/goOquwO.png Screenshot]
  
{{TOC limit|3}}
+
The script will run on the place, and colored banners will appear at the top of the sidebar with information on the place status.
<br>
 
== <translate><!--T:4-->
 
Browser requirements</translate> ==
 
<div style="border:solid 2px #ffbb00;  border-radius: 100px 0px 0px; background: #8AC007; padding: .5em 1em 0em; background-color:transparent; color:#000;zoom: 1"><!--
 
--><div style="padding:1ex 1ex 0ex; ">
 
{{Anchor|browsers|Chrome|Chrome / Blink / Opera Next|Firefox|Firefox / Mozilla|Internet Explorer|Safari|Monkey|<translate><!--T:5-->
 
Greasemonkey or Tampermonkey add-on for script management</translate>}}
 
{{Expand|/Browser requirements|General installation instructions|section=3|summary=<translate><!--T:6-->
 
Click Expand for details on general installation info for specific browsers, and the [http://tampermonkey.net/ Tampermonkey], and [http://addons.mozilla.org/en-US/firefox/addon/greasemonkey/ Greasemonkey] script managers.</translate> <br>''(Chrome / Blink / Opera Next / Firefox / Mozilla / Internet Explorer / Safari)''}}
 
</div></div>
 
  
== <translate><!--T:7-->
+
<span style="color:#fff; background:#24ac24">Green</span> indicates no major issues were found and place is locked. [http://i.imgur.com/Vq2CMHy.png Screenshot]
Map Editor presentation enhancements</translate> ==
 
{{NewScript|WME ClickSaver}}
 
{{NewScript|WME Color Highlights}}
 
{{anchor|Waze_Edit_Count_Monitor}}{{NewScript|Waze Edit Count Monitor}}
 
{{NewScript|WME HardHats}}
 
{{NewScript|WME Highlighter City}}
 
{{NewScript|WME Junction Angle info}}
 
{{NewScript|WME layout tweaking user style}}
 
{{NewScript|WME Level Highlighter}}
 
{{NewScript|WME LiveMap closures}}
 
{{NewScript|WME Place Interface Enhancements}}
 
{{NewScript|ShowTown}}
 
{{anchor|Street_Vector_Layer}}{{NewScript|Street Vector Layer}}
 
{{anchor|WME Street View Availability}}{{NewScript|WME Street View Availability}}
 
{{anchor|WME Tab Manager}}{{NewScript|WME Tab Manager}}
 
{{anchor|UR Comments}}{{NewScript|URComments}}
 
{{anchor|UR_Overview_Plus}}{{NewScript|UR Overview Plus (URO+)}}
 
  
== <translate><!--T:8-->
+
<span style="color:#fff; background:#3232e6">Blue</span> indicates that minor issues were found, but place is locked. [http://i.imgur.com/OfBoocB.png Screenshot]
Map Editing</translate> ==
 
{{anchor|Waze Aerial Shifter}}{{NewScript|WME Aerial Shifter (WAS)}}
 
{{NewScript|WME center to begin-end of street}}
 
{{anchor|WME Junction Node Fixer (JNF)}}{{NewScript|WME Junction Node Fixer}}
 
{{NewScript|WME Magic Wand}}
 
{{NewScript|WME Roundabout Angles}}
 
{{NewScript|Street to River PLUS}}
 
{{NewScript|WME Road Selector}}
 
{{NewScript|WME Place Harmonizer}}
 
{{NewScript|WME PlaceNames}}
 
{{anchor|Install WME Toolbox|Update WME Toolbox|WME Toolbox features|Toolbar|Highlight layers menu|And more|More information}}{{NewScript|WME Toolbox}}
 
  
== <translate><!--T:9-->
+
<span style="color:#fff; background:#d9ad2a">Orange</span> indicates that something was found that potentially needs editor attention. [http://i.imgur.com/R2YE4Pi.jpg Screenshot]
Map validation and routing</translate> ==
 
{{NewScript|WME Route Checker}}
 
{{NewScript|WME Route Speeds (Traffic)}}
 
{{NewScript|WME Speedhelper}}
 
{{NewScript|WME Validator}}
 
  
== <translate><!--T:10-->
+
<span style="color:#fff; background:#d33030">Red</span> means that an issue was found that prevented place locking. [http://i.imgur.com/jKp5Vxi.png Screenshot]
WME Chat</translate> ==
+
Banners contain buttons which do various things as described below
{{NewScript|WME Chat addon}}
 
{{NewScript|WME Chat Jumper}}
 
{{NewScript|WME Chat Resizer and Auto Scroll}}
 
  
== <translate><!--T:11-->
+
The script doesn’t automatically save, so you can always undo the changes it has made using the normal WME undo button.
Device</translate> ==
+
After running the script, fix any missing or incorrect info.  You can run the script multiple times and it will adjust to the updated info.
<div style="border:solid 2px #93C4D3;  border-radius: 100px 0px 0px; background: #8AC007; padding: .5em 1em 0em; background-color:transparent; color:#000;zoom: 1"><!--
+
Once the place info looks good, save !
--><div style="padding:1ex 1ex 0ex; ">
 
=== <translate><!--T:12-->
 
Geocaching</translate> ===
 
<translate><!--T:13-->
 
This is a bookmarklet for iOS to integrate the Geocaching client with the Waze client for navigation. It has been moved to the [[Bookmarklets#Geocaching|Bookmarklets]] page.</translate></div></div>
 
  
{{NewScript|Toggelis Waze Editor}}
+
<span style="color:#FF0000; background:#fff">NOTE: The script sometimes offers links to search the web for a place's website. DO NOT copy and paste information from 3rd party sources like Google.  Visit the place website and gather information from there instead.</span>
  
== <translate><!--T:14-->
+
==Screencasts (Watch how it works!)==
Live Map</translate> ==
+
[http://quick.as/02lyC77Yq Basic example of a non-chain place]
{{NewScript|Live Map UR Overlay (LMUR)}}
+
[http://quick.as/kV92U55qo Basic example of a chain place]
 +
[http://quick.as/GR2vTzzPa Basic example of duplicate finder and error checking]
 +
[http://quick.as/bRAqTOOr1 WMEPH Whitelisting Feature]
 +
[http://quick.as/V21pC22zL Place Info Cloning Feature (Rank 3+)]
  
== Stylish ==
+
=Feature List=
{{NewScript|Increased width on the Waze Wiki}}
+
<span style="color#DD00DD">New in v. 1.1: Place Highlighter</span>:
 +
Place highlighting for all map markers shows places that need work.  The highlighting works with your whitelisting settings.  At this time, it does not check chain-specific errors. Options allow for disabling the use of Whitelist data and also suppressing highlights for the Missing Hours flag.  [http://i.imgur.com/623BwaQ.png Highlight Key]  [http://i.imgur.com/oz8WnzH.jpg Sample Screenshot]
  
== Bookmarklets ==
+
==For chains on the PNH data sheet==
<div style="border:solid 2px #93C4D3; border-radius: 100px 0px 0px; background: #8AC007; padding: .5em 1em 0em; background-color:transparent; color:#000;zoom: 1"><!--
+
Names, Categories, and URL are updated from standard information, as long as the data has been approved by a moderator for your area. [http://i.imgur.com/hzS7Q9l.png Screenshot]  New places and existing place approvals are always being added. 
--><div style="padding:1ex 1ex 0ex; ">
+
Note: The script matches places with PNH entries based on the place name.  Some variation is accounted for, but misspellings and extraneous info in the place name may prevent a match.  Feel free to report these to improve the matching algorithms.
 +
Reminder messages for certain places are displayed, including hotel localization, special cases, alternate names, and optional place information.  Some are easily applied with a single click [http://i.imgur.com/VkD6Upc.png Screenshot].
 +
Places on the sheet but not approved for the state/region provide a link to an approval form.
 +
New chains can be submitted through the banner button. [http://i.imgur.com/sg1gu4Q.png Screenshot]
 +
 
 +
==Place fields checked and updated==
 +
===Category===
 +
* Unlikely and parent categories are flagged. [http://i.imgur.com/PZmkU4q.png Screenshot]
 +
* Category-based reminders and options are provided. [http://i.imgur.com/17m4Vlh.png Screenshot] [http://i.imgur.com/73JUnyz.png Screenshot]
 +
* Hospitals and Schools with unlikely names (dentist, etc.) are flagged with options to change to Offices or Pet/Vet Services. [http://i.imgur.com/kh0ukSE.png Hospital Screenshot] [http://i.imgur.com/Nfi4nFn.png School Screenshot]
 +
 
 +
===Name===
 +
* Place names are automatically capitalized, with option to force full Title Casing
 +
* Any alt-names are checked for search functionality, and unnecessary alt-names are removed (e.g., For Starbucks, starbuck and starbucks alts from the recent ad campaign are useless)
 +
 
 +
===Description===
 +
* Updated from PNH data where applicable
 +
* Checked for special cases such as Pharmacy hours for some chains [http://i.imgur.com/YOR1J7I.png Screenshot]
 +
 
 +
===Lock level===
 +
* Places with complete address information and no major flags are locked according to the place category and the locking rules of the state/region
 +
* Places with invalid or bad info or not in line with wiki rules are not locked
 +
 
 +
===Point vs. Area===
 +
* Places are checked for Point vs. Area based on the [https://wiki.waze.com/wiki/Places#When_to_use_Area_or_Point Places wiki] and flagged. [http://i.imgur.com/Ljg6j6p.png Screenshot]
 +
* A button allows quick change to the right geometry type. When changing from area to point, the button uses the stop point as the location of the new point
 +
* Exceptions for states/regions are incorporated into the script.  Please report any discrepancies
 +
 
 +
===Address===
 +
* House numbers are checked for length and format, flagging anything out of spec, or if it’s missing.  [http://i.imgur.com/WVXkrWm.png Screenshot]
 +
* Street and City fields are flagged if missing.
 +
* Checks HN against nearby addresses to see if there is a potential issue with the HN or street name
 +
Places with “No Address” have no information at all, so the script uses nearest segments to infer country, state, city, and street information.  This is used to refine searching, but also this can (optionally for R3+) be applied to the place point address fields. [http://i.imgur.com/21RdgLZ.jpg Screenshot]. (When running the script on PURs at low zoom, the script will not run on places with "No Address" since it needs to be zoomed to see the nearby streets.  There is an option to enable auto-zoom for these cases.)
 +
 
 +
===Website===
 +
* Unnecessary protocols such as http:// are stripped from URLs while https:// remains
 +
* Deep links (eg: store info pages) can be optionally preserved when matching from PNH data, as long as domains match
 +
* URLs are formatted (WWW -> www, etc.)
 +
* Banner buttons provide links to the store website or store locator page (some of which auto-fill the place location).  [http://i.imgur.com/ylkeOvU.jpg Store locator] [http://i.imgur.com/rW9wCto.jpg Web search] [http://i.imgur.com/ti69WFv.jpg Place website]
 +
 
 +
===Phone===
 +
* Validates phone field for invalid area codes and exchanges, or incorrect number of digits.  [http://i.imgur.com/R2YE4Pi.jpg Screenshot]
 +
* Flag Area codes that are out of state [http://i.imgur.com/aieKHAO.png Screenshot]
 +
* Reformats phone into proper style for the country/region/state. [http://i.imgur.com/Nw5Idmn.png Screenshot]
 +
* Alphanumeric phones like 1-800-CAR-4YOU can be entered in the phone field and the script will convert them.
 +
 
 +
===Services===
 +
* Common services based on category can be optionally added automatically
 +
* Services can be toggled from the banners using clickable icons. [http://i.imgur.com/DPJnnHR.png Screenshot]
 +
 
 +
===Hours===
 +
* Places with unlikely hours are flagged. [http://i.imgur.com/t7bHQRI.png Screenshot]
 +
* A 24/7 icon is available on the banners for quick addition of those hours. [http://i.imgur.com/zhH3tzY.png Screenshot]
 +
* Places with missing hours are flagged and a text box is provided where you can enter the hours in two different ways.  [http://i.imgur.com/z4F57Ts.png Screenshot]
 
<br />
 
<br />
<translate><!--T:15-->
+
Copy the hours from the place website and paste into the box. You can either add to the existing hours for sequential adding, or use the replace button to replace any existing hours. The script tries to parse the pasted info and if the text is reasonably well-formatted, it automatically updates the hours in the WME place.  Auto-switching to the More Info tab allows you to verify
Several very useful [http://en.wikipedia.org/wiki/Bookmarklet bookmarklet] scripts have been developed to enhance the WME map editing process. A complete list of available scripts are on the [[Bookmarklets]] Wiki page along with instructions on how to add them to your browser.</translate>
+
You can enter hours in the box by typing them.  Typically, enter the days followed with the times using 24hr time and/or am/pm.  Use dashes for ranges of days and hours.  You can use single (MTWRFSU), double (MoTuWe etc) or triple letter (MonTueWed etc) abbreviations for the days.<br /><br />
</div></div>
+
Example:  '''M-W 9-17 ThSu 10-4p FriSat 9a-9p''' would set up the hours<br />
 +
Mon, Tue, Wed from  9a-5p<br />
 +
Thu & Sun from 10a-4p<br />
 +
Fri & Sat from 9a-9p
 +
 
 +
==Other Script Functions==
 +
===Gas Stations===
 +
* Brands are checked and flagged if they do not match the primary name.  One click to update the name and move the existing name to the alt-name. [http://i.imgur.com/XxVeTT2.png Screenshot]
 +
* “Unbranded” is flagged, since it is not used
 +
* Convenience Store category added to stations with one click, or optionally automatically. [http://i.imgur.com/Sf9teUv.png Screenshot]
 +
 
 +
===Residential Points===
 +
* Regular points with residential-type names such as “My House” are flagged
 +
* Residential points are stripped of unneeded information and (optionally) locked
 +
 
 +
===Rest areas===
 +
* Detected based on names and categories
 +
* Names are checked against Wiki specs
 +
 
 +
===Duplicate finder===
 +
* Highlights nearby places that have similar names, including whether they have photos on them. [http://i.imgur.com/ltG0mY4.jpg Screenshot]
 +
* Optionally zooms and centers the map so that all nearby duplicates can be easily seen
 +
 
 +
===Place Whitelisting===
 +
* Whitelisting buttons (‘WL’) appear on some banner flags, which adds the field to a list so that the script doesn’t consider that piece of information missing or out of spec ever again.  For example, a park may have no house number; after pressing the WL button, the script will no longer indicate a severe error. Places that don’t operate a website can be WL’d, etc.  [http://i.imgur.com/N3BVGc5.png Screenshot]
 +
* Whitelists can be backed up and merged, enabling sharing between editors in the same area to avoid editors researching the same information multiple times.  [http://i.imgur.com/DBDpk8p.png Screenshot]
 +
* To backup and/or share a list, press the pull button and copy the retrieved information from the text box.  Save locally or email to fellow editors. 
 +
* To merge a list, first paste the list into the textbox and then press merge.  Places on the new list will be added to any places already in your existing list, so no data is lost.  This is also how you can restore a backup in case of data loss in the browser
 +
* To share a list to a public Google sheet, use the Share button, which links to a form where you can submit the data (limited data capacity at present)
 +
* To view your whitelist stats by state and country, use the Stats button
 +
* To remove all WL data for a single state, enter the state name as shown in the stats list, and use the Remove State button
 +
* Future feature: Whitelist info can be integrated with place highlighting so that editors can see which places still need review
 +
 
 +
===Place Cloning===
 +
''Available for R3+''<br />
 +
Copy information from a selected place, then paste selected info into other places that share the same information.  Examples: businesses in malls that share the same address; college campuses where all buildings share address, url, and phone; businesses that share the same street and city name.  To use, enable the tool in the settings tab.  It will appear under the Run WMEPH button when you select a place. [http://i.imgur.com/tGtiY2Z.png Screenshot] Select the place with the info you want to use for other places, and press copy. Select a place you want to clone the info to, and check the boxes for the info you want to clone:<br /><br />
 +
HN = House Number<br />
 +
Str = Street<br />
 +
City = City, State, Country<br />
 +
URL<br />
 +
Ph = Phone<br />
 +
Desc = Description<br />
 +
Serv = Services<br />
 +
Hrs = Hours<br /><br />
 +
3 Buttons allow selection if all, none, or just the address fields.  Then, press paste, and the info will be applied to the selected place.  Repeat with as many places as desired.  Copied info is removed when WME is reloaded.
 +
 
 +
===Convenient Zooming===
 +
* Press Ctrl-Alt-z.  If you have a place selected, it zooms to the 50ft level and centers the place.  If you don’t have a place selected, it zooms to the 200ft level, and centers it around where ever you have the mouse cursor at the time.
 +
 
 +
=Acknowledgements=
 +
*The current Dev Team: MapOMatic, RavenDT
 +
 
 +
*All the hard work by the previous development team in making this script a reality. You are all invited to rejoin the effort!
 +
 
 +
*Previous development team: bmtg, vtpearce, cardyin, jtsmith2, joyriding, fjsawicki, CoolCanuck, & sar851
 +
 
 +
*PNH admins: tonestertm, t0cableguy, & ialangford; CoolCanuck
 +
 
 +
*All the Beta testers and editors who submit bugs and feature requests
 +
 
 +
*rickzabel & slemmon2 for solving some Firefox issues
 +
 
 +
*All the WME script writers out there who have written many great codes.
  
== <translate><!--T:16-->
 
Adding a new script</translate> ==
 
<div style="border:solid 2px #93C4D3;  border-radius: 100px 0px 0px; background: #8AC007; padding: .5em 1em 0em; background-color:transparent; color:#000;zoom: 1"><!--
 
--><div style="padding:1ex 1ex 0ex; ">
 
<br />
 
<translate><!--T:17-->
 
To add a new script section to this page please add the</translate> '''{{tlx|NewScript|<translate><!--T:18-->
 
SCRIPT TITLE</translate>}}''' <translate><!--T:19-->
 
template to this page in the position where you would like the new section to be. After saving the page, expand the new section and click the link to add the script details.</translate></div></div>
 
  
== <translate><!--T:20-->
+
=Development=
Developing scripts</translate> ==
+
If you have an interest in developing the script, or have an interest in helping us beta test any bugs or features while providing regular feedback please contact {{Username|t0cableguy}}
<div style="border:solid 2px #93C4D3;  border-radius: 100px 0px 0px; background: #8AC007; padding: .5em 1em 0em; background-color:transparent; color:#000;zoom: 1"><!--
+
We also need help with localization, and ROW support. Anyone can fork and do a pull request at [https://github.com/WazeUSA/WME-Place-Harmonizer Github] with any bugfixes, or feature additions.
--><div style="padding:1ex 1ex 0ex; ">
+
 
<translate><!--T:21-->
+
 
Please see</translate> [[Scripts/WME JavaScript development]].
+
=Installation=
</div></div>
+
<!-- PLACE ALL SCRIPT DESCRIPTIONS ABOVE THIS LINE. DOWNLOAD LINKS GO BELOW -->
 +
 
 +
↓ {{U|'''DOWNLOAD'''}} ↓
 +
* [https://github.com/WazeUSA/WME-Place-Harmonizer/raw/master/WME-Place-Harmonizer.user.js WME Place Harmonizer]
  
[[Category:Waze Map Editor]]
+
{{Clear}}
 +
{{ForumLink
 +
|forum=https://www.waze.com/forum/viewtopic.php?f=819&t=215657<!-- place forum thread URL here-->}}

Revision as of 05:56, 15 February 2017

Wmeph.png

WME Place Harmonizer is a script originally written by BMTG (PM)  Profile L2.png. WMEPH helps with all aspects of editing places except update requests. The script team is administered by t0cableguy (PM)  Profile L2.png, and the lead developer is MapOMatic (PM)  Profile L2.png.

The script validates, formats, and harmonizes the information for a selected place. It pulls standardized info for over 1800 chains from the PNH (Place Name Harmonization) data sheets. Places that are complete are automatically locked to the appropriate level based on category and location of the place (i.e. state/region/country rules are applied). Banners above the place information sidebar provide feedback on what is missing or out of spec with the place region's wiki guidance. Links to websites, search results, and PNH submission forms make working on places faster and easier. Hours can be added by pasting info from the place’s website or using shorthand entry. An optional yet highly useful highlighting feature shows places on the map needing work.

Basic Functionality

  • Color highlights and borders are placed on each place on the map according to the image above. Each type indicates a different problem, or completion level.
  • When "Run Wmeph" is pressed several items appear at the top of the Place panel and provide places for you to input the relevant information. You will search accordingly and input information into each field and click add. WMEPH formats and inserts the information into the right place in the place panel. Re running the checks by pressing "Run WMEPH" will recheck the fields and lock the place when the values are all present.
  • The script will match names to chains in the Place Name Harmonization list when matches are found.

Who can use it

Any editor rank 2 and up, editing in USA or Canada. (Some script options are restricted to higher ranked editors.)

How to use

Select a place in WME.

Press the “Run WMEPH” button at the top of the sidebar Screenshot, or press the keyboard shortcut. The default is Alt-Shift-A; you can change this in the WMEPH preferences panel. (use a lowercase letter if you don't want the Shift key in the shortcut) Screenshot

The script will run on the place, and colored banners will appear at the top of the sidebar with information on the place status.

Green indicates no major issues were found and place is locked. Screenshot

Blue indicates that minor issues were found, but place is locked. Screenshot

Orange indicates that something was found that potentially needs editor attention. Screenshot

Red means that an issue was found that prevented place locking. Screenshot Banners contain buttons which do various things as described below

The script doesn’t automatically save, so you can always undo the changes it has made using the normal WME undo button. After running the script, fix any missing or incorrect info. You can run the script multiple times and it will adjust to the updated info. Once the place info looks good, save !

NOTE: The script sometimes offers links to search the web for a place's website. DO NOT copy and paste information from 3rd party sources like Google. Visit the place website and gather information from there instead.

Screencasts (Watch how it works!)

Basic example of a non-chain place Basic example of a chain place Basic example of duplicate finder and error checking WMEPH Whitelisting Feature Place Info Cloning Feature (Rank 3+)

Feature List

New in v. 1.1: Place Highlighter: Place highlighting for all map markers shows places that need work. The highlighting works with your whitelisting settings. At this time, it does not check chain-specific errors. Options allow for disabling the use of Whitelist data and also suppressing highlights for the Missing Hours flag. Highlight Key Sample Screenshot

For chains on the PNH data sheet

Names, Categories, and URL are updated from standard information, as long as the data has been approved by a moderator for your area. Screenshot New places and existing place approvals are always being added. Note: The script matches places with PNH entries based on the place name. Some variation is accounted for, but misspellings and extraneous info in the place name may prevent a match. Feel free to report these to improve the matching algorithms. Reminder messages for certain places are displayed, including hotel localization, special cases, alternate names, and optional place information. Some are easily applied with a single click Screenshot. Places on the sheet but not approved for the state/region provide a link to an approval form. New chains can be submitted through the banner button. Screenshot

Place fields checked and updated

Category

Name

  • Place names are automatically capitalized, with option to force full Title Casing
  • Any alt-names are checked for search functionality, and unnecessary alt-names are removed (e.g., For Starbucks, starbuck and starbucks alts from the recent ad campaign are useless)

Description

  • Updated from PNH data where applicable
  • Checked for special cases such as Pharmacy hours for some chains Screenshot

Lock level

  • Places with complete address information and no major flags are locked according to the place category and the locking rules of the state/region
  • Places with invalid or bad info or not in line with wiki rules are not locked

Point vs. Area

  • Places are checked for Point vs. Area based on the Places wiki and flagged. Screenshot
  • A button allows quick change to the right geometry type. When changing from area to point, the button uses the stop point as the location of the new point
  • Exceptions for states/regions are incorporated into the script. Please report any discrepancies

Address

  • House numbers are checked for length and format, flagging anything out of spec, or if it’s missing. Screenshot
  • Street and City fields are flagged if missing.
  • Checks HN against nearby addresses to see if there is a potential issue with the HN or street name

Places with “No Address” have no information at all, so the script uses nearest segments to infer country, state, city, and street information. This is used to refine searching, but also this can (optionally for R3+) be applied to the place point address fields. Screenshot. (When running the script on PURs at low zoom, the script will not run on places with "No Address" since it needs to be zoomed to see the nearby streets. There is an option to enable auto-zoom for these cases.)

Website

  • Unnecessary protocols such as http:// are stripped from URLs while https:// remains
  • Deep links (eg: store info pages) can be optionally preserved when matching from PNH data, as long as domains match
  • URLs are formatted (WWW -> www, etc.)
  • Banner buttons provide links to the store website or store locator page (some of which auto-fill the place location). Store locator Web search Place website

Phone

  • Validates phone field for invalid area codes and exchanges, or incorrect number of digits. Screenshot
  • Flag Area codes that are out of state Screenshot
  • Reformats phone into proper style for the country/region/state. Screenshot
  • Alphanumeric phones like 1-800-CAR-4YOU can be entered in the phone field and the script will convert them.

Services

  • Common services based on category can be optionally added automatically
  • Services can be toggled from the banners using clickable icons. Screenshot

Hours

  • Places with unlikely hours are flagged. Screenshot
  • A 24/7 icon is available on the banners for quick addition of those hours. Screenshot
  • Places with missing hours are flagged and a text box is provided where you can enter the hours in two different ways. Screenshot


Copy the hours from the place website and paste into the box. You can either add to the existing hours for sequential adding, or use the replace button to replace any existing hours. The script tries to parse the pasted info and if the text is reasonably well-formatted, it automatically updates the hours in the WME place. Auto-switching to the More Info tab allows you to verify You can enter hours in the box by typing them. Typically, enter the days followed with the times using 24hr time and/or am/pm. Use dashes for ranges of days and hours. You can use single (MTWRFSU), double (MoTuWe etc) or triple letter (MonTueWed etc) abbreviations for the days.

Example: M-W 9-17 ThSu 10-4p FriSat 9a-9p would set up the hours
Mon, Tue, Wed from 9a-5p
Thu & Sun from 10a-4p
Fri & Sat from 9a-9p

Other Script Functions

Gas Stations

  • Brands are checked and flagged if they do not match the primary name. One click to update the name and move the existing name to the alt-name. Screenshot
  • “Unbranded” is flagged, since it is not used
  • Convenience Store category added to stations with one click, or optionally automatically. Screenshot

Residential Points

  • Regular points with residential-type names such as “My House” are flagged
  • Residential points are stripped of unneeded information and (optionally) locked

Rest areas

  • Detected based on names and categories
  • Names are checked against Wiki specs

Duplicate finder

  • Highlights nearby places that have similar names, including whether they have photos on them. Screenshot
  • Optionally zooms and centers the map so that all nearby duplicates can be easily seen

Place Whitelisting

  • Whitelisting buttons (‘WL’) appear on some banner flags, which adds the field to a list so that the script doesn’t consider that piece of information missing or out of spec ever again. For example, a park may have no house number; after pressing the WL button, the script will no longer indicate a severe error. Places that don’t operate a website can be WL’d, etc. Screenshot
  • Whitelists can be backed up and merged, enabling sharing between editors in the same area to avoid editors researching the same information multiple times. Screenshot
  • To backup and/or share a list, press the pull button and copy the retrieved information from the text box. Save locally or email to fellow editors.
  • To merge a list, first paste the list into the textbox and then press merge. Places on the new list will be added to any places already in your existing list, so no data is lost. This is also how you can restore a backup in case of data loss in the browser
  • To share a list to a public Google sheet, use the Share button, which links to a form where you can submit the data (limited data capacity at present)
  • To view your whitelist stats by state and country, use the Stats button
  • To remove all WL data for a single state, enter the state name as shown in the stats list, and use the Remove State button
  • Future feature: Whitelist info can be integrated with place highlighting so that editors can see which places still need review

Place Cloning

Available for R3+
Copy information from a selected place, then paste selected info into other places that share the same information. Examples: businesses in malls that share the same address; college campuses where all buildings share address, url, and phone; businesses that share the same street and city name. To use, enable the tool in the settings tab. It will appear under the Run WMEPH button when you select a place. Screenshot Select the place with the info you want to use for other places, and press copy. Select a place you want to clone the info to, and check the boxes for the info you want to clone:

HN = House Number
Str = Street
City = City, State, Country
URL
Ph = Phone
Desc = Description
Serv = Services
Hrs = Hours

3 Buttons allow selection if all, none, or just the address fields. Then, press paste, and the info will be applied to the selected place. Repeat with as many places as desired. Copied info is removed when WME is reloaded.

Convenient Zooming

  • Press Ctrl-Alt-z. If you have a place selected, it zooms to the 50ft level and centers the place. If you don’t have a place selected, it zooms to the 200ft level, and centers it around where ever you have the mouse cursor at the time.

Acknowledgements

  • The current Dev Team: MapOMatic, RavenDT
  • All the hard work by the previous development team in making this script a reality. You are all invited to rejoin the effort!
  • Previous development team: bmtg, vtpearce, cardyin, jtsmith2, joyriding, fjsawicki, CoolCanuck, & sar851
  • PNH admins: tonestertm, t0cableguy, & ialangford; CoolCanuck
  • All the Beta testers and editors who submit bugs and feature requests
  • rickzabel & slemmon2 for solving some Firefox issues
  • All the WME script writers out there who have written many great codes.


Development

If you have an interest in developing the script, or have an interest in helping us beta test any bugs or features while providing regular feedback please contact t0cableguy (PM)  Profile L2.png We also need help with localization, and ROW support. Anyone can fork and do a pull request at Github with any bugfixes, or feature additions.


Installation

DOWNLOAD

Bring up comments or questions on this page in this forum Forum topic unread.gif.