Installation
After purchasing City Blocks Pro, on the invoice screen, click the Download City Blocks button to download the plugin zip file. Copy the License key after downloading the zip file.
If you navigate from the invoice screen before copying your license key, the license information can be found by navigating to Licenses in your account. Find your purchased plugin and click the key icon to copy your license key.
Next, in your WordPress installation, navigate to Dashboard > Plugins > Add New Plugin. Upload City Blocks Pro and activate. Next, navigate to Dashboard > Setting > City Blocks . Enter your license key in the license key field to activate the plugin.
Settings
UTM Settings
Click the “UTM” tab to add a UTM set. Click the “Add” button to add your desired UTM codes. After adding a set, a list view will appear with the set just added. To edit a set, click the set name under the “Set” column. After editing, click the “Update UTM Set” button to apply the changes. To download or delete a UTM set of multiple sets, click the checkboxes to the left of the set name. A “Delete” and “Download” button will appear to the left of the add button.
Using City Blocks Pro
Navigate to the editor and type /City Blocks. At least 1 Area is nested inside the City Blocks. The City Blocks settings are located in the block's inspector panel. Select a default Area in the event the area is not covered by City Blocks. Areas can be renamed by navigating the list view panel, clicking the 3 vertical dots to the right of the Area, and clicking “Rename”
Area Block Settings
Enter the zip code or city to be covered by City Blocks. Currently, only the United States is supported. To handle ambiguous cities, append the state to the target city. Ex. Oakland California or Oakland Michigan.
NOTE: City Blocks cannot guarantee coverage for your desired area. The City Blocks coverage library is updated frequently.
Adding UTM Codes to Area Blocks
There are a couple of ways to add UTM codes to the City Blocks' “Areas”.
Manually on each area block
With the area block selected, open the UTM Settings tab in the inspector panel. Manually fill out each field.
Via UTM Sets dropdown
Use the dropdown in the UTM Settings tab to automatically fill out the UTM field.
Logs
Click the “Logs” tab to view the traffic logs of City Blocks Pro. Each entry is the post or page title where the City Blocks was used. Click the entry title to expand the logs. Each log entry contains a record of the Date and time, IP address, protocol, *referrer, and UTM codes.
* There will be instances where the referrer is not recorded, or the host link is returned. This can happen for several reasons, but in most cases due to the referring source.