# Map List Pro

## List Locations Easily

- Created: 03/10/2011
- latest Update: 07/06/2012
- By: SmartRedFox & EireTek
- Email: bothamj@gmail.com

The Map List Pro plugin lists all, or a selection of, locations that you have created through the included Location custom post type. It also allows you to embed multiple lists in a page or post – these can be limited by categories, or by picking the locations from a list. Users can sort, filter, and search locations easily, making Map List Pro perfect for store and business location pages.

### Installation

To install File List Pro:

1. Log in to your Wordpress site admin.
2. Go to Plugins --> Add New.
3. Choose the Upload option (near the top of the page).
4. Click browse and select the zip file for Map List Pro.
5. Once you've selected the file click Install Now.
6. Once the plugin is uploaded and installed choose Activate Plugin.

### Creating Locations

Map Locations for Map List Pro can be created quickly and easily through the Wordpress Admin interface:

1. Click On Map Locations on the main menu.
2. Choose Add New.
3. There are two main ways to specify where your location is:
   1. By Searching - Start typing into the Search by address box and Map List Pro will search for the location using Google Maps. When you see your location in the list click on it and it will prefill the appropriate fields for you.
   2. By Latidtude/Longitude - Enter the Latitude and Longitude for the location and click Go to select it on the map.
4. If you searched for your location most fields will be precompleted for you, if not you will need to fill in The Title, Description, and Address for the location.
5. You can also add Location categories in for this location. This allows you to filter the locations in lists.

### Adding a map list to your page

To add a Map List to your page you just need to click the Map List Pro button in the editor. This will let you pick the options you want to use for the list and add a shortcode to your page or post.

The first thing you need to decide is if you want to pick locations from a list, or filter the locations by categories. You then need to click on the corresponding tab.

#### List locations by picking them

This option lets you create a map list with just the locations you want to display. Just check the locations you want to include by ticking them.

#### List locations by category

This is the best option if you want to list all files from a certain category, and you want the list to update itself as new locations are created. Pick the categories you want to display from the list.

#### Show all locations

To show all locations pick the "By Category" tab and leave all categories unticked.

#### Sorting

You can choose what direction the map list will be sorted initially - ascending or descending by title.

#### Other Options

The rest of the options allow you to customise how the file list looks:

- Locations per page – this is the number of files that should be shown before paging kicks in.
- Hide search, Hide sort, Hide filter – these allow you to customise the display of individual lists by hiding pieces of functionality.

Once you have chosen all of your options click the Insert button and a shortcode will be entered into your content.

If you prefer you can enter the shortcode manually. Below is a shortcode with all possible attributes specified. When creating your own shortcode you can probably leave most of these out.

[maplist categories="6,3" orderdir="ASC" hidefilter="true" hidesort="true" hidesearch="true" locationsperpage="5" locationstoshow="236,207,189"]

### Options and Settings

Options for location lists can be set at a site level via the settings page. To access these settings go to Settings -> Map List Pro.
The following options can be set:

- Style – Map List Pro comes with 18 core styles ready to use. Select the style you want to use from the list and look at the preview to make sure it matches your site. When you’ve found the style you like, click Save.
- Other options – These options let you hide or show the additionaly functionality on file lists. These options are site-wide and if set to hide WILL override options set on individual lists.

### Further Customisation

#### Creating your own style

You can create your own styles for Map List Pro easily – the plugin has been designed so that future updates will not remove your styles.
Just create a /prettymapstyles/ folder in your active theme directory and copy one of the existing css files into it. This will then show in the Map List Pro settings page with (custom) next to it. Make any changes you need to this file – most of the colours and core styles are at the bottom of the css files to make customisation easier.

### Having problems? Get in touch.

If you run into any problems during installation, use, or styling please feel free to get in touch with me so I can help.