IronMaps™ Documentation

Overview

IronMaps™ represents the next generation of WordPress mapping solutions, specifically engineered for modern WordPress installations and contemporary web standards. Built by IronGlove Studio® with a focus on performance, security, and reliability, this plugin leverages current PHP capabilities and WordPress best practices to deliver enterprise-grade mapping functionality to businesses of all sizes.

Our commitment to supporting modern server environments ensures optimal performance, enhanced security, and future-proof compatibility. IronMaps™ is designed to work seamlessly with today's hosting standards while providing the robust features your organization needs for effective location management and community engagement.

WordPress Requirements

Core Platform

• WordPress Version: 6.0 or higher (6.4+ recommended)
• Admin Access: Administrator privileges required for initial setup and configuration

Recommended WordPress Configuration

• Latest stable WordPress version for optimal security and performance
• WordPress REST API enabled (default in supported versions)
• Pretty permalinks enabled for enhanced SEO and user experience

Server Requirements

PHP Environment

• PHP Version: 8.0, 8.1, 8.2, or 8.3
• Recommended: PHP 8.2 or 8.3 for optimal performance and security
• PHP Extensions Required:
  • curl (for external mapping service communication)
  • json (for data processing and API responses)
  • mbstring (for international character support)
  • openssl (for secure connections)
  • zip (for data import/export functionality)

Database Requirements

• MySQL: Version 5.7 or higher
• MariaDB: Version 10.3 or higher
• Database Privileges: CREATE, DROP, SELECT, INSERT, UPDATE, DELETE
• Character Set: UTF8 or UTF8MB4 (recommended for emoji and international content)

Server Configuration

• PHP Memory Limit: 128MB minimum (256MB recommended for larger datasets)
• Maximum Execution Time: 30 seconds minimum (60 seconds recommended)
• Post Max Size: 8MB minimum (for bulk location imports)
• Upload Max Filesize: 2MB minimum (for media attachments)
• Max Input Variables: 1000 minimum (3000 recommended for complex filtering)

Web Server Requirements

Supported Web Servers

• Apache: 2.4+ with mod_rewrite enabled
• Nginx: 1.18+ with proper WordPress configuration
• LiteSpeed: Compatible with WordPress-optimized configurations
• IIS: 10+ with URL Rewrite Module (for Windows Server environments)

Security Requirements

• HTTPS: SSL certificate required for production environments
• TLS Version: 1.2 or higher for secure API communications
• File Permissions: Proper WordPress file permission structure (755 for directories, 644 for files)

Browser Compatibility

Supported Browsers

• Chrome: Version 90+ (recommended for optimal experience)
• Firefox: Version 88+
• Safari: Version 14+
• Edge: Version 90+
• Mobile Browsers: iOS Safari 14+, Chrome Mobile 90+

JavaScript Requirements

• ECMAScript: ES6+ support required
• JavaScript: Must be enabled for full functionality
• Cookies: Must be enabled for admin functionality and user preferences

Performance Recommendations

Hosting Environment

• SSD Storage: Recommended for database performance
• HTTP/2: Supported and recommended for enhanced loading speeds
• PHP OPcache: Enabled for improved PHP performance
• Object Caching: Redis or Memcached recommended for high-traffic sites

Network Requirements

• Outbound Connections: Required for mapping service APIs and license validation
• Bandwidth: Minimum 1Mbps for real-time mapping features
• Latency: <100ms recommended for optimal user experience

Compatibility Notes

Plugin Compatibility

• Caching Plugins: Compatible with major caching solutions (WP Rocket, W3 Total Cache, WP Super Cache)
• Security Plugins: Compatible with Wordfence, Sucuri, and other major security plugins
• SEO Plugins: Full compatibility with Yoast SEO, RankMath, and All in One SEO

Theme Compatibility

• Block Themes: Full support for WordPress block-based themes
• Classic Themes: Compatible with traditional WordPress themes
• Page Builders: Tested with Elementor, Beaver Builder, and Divi

Installation Verification

Before installing IronMaps™, you can verify your server meets these requirements by:

1. Checking PHP version through your hosting control panel or WordPress dashboard
2. Reviewing WordPress version in the WordPress admin dashboard
3. Confirming database version through your hosting provider's database management tools
4. Testing server configuration using WordPress's built-in Site Health tool

Support and Updates

IronMaps™ follows WordPress security and compatibility standards, ensuring regular updates and continued compatibility with evolving WordPress core features. Our commitment to modern PHP support guarantees your mapping solution will remain secure and performant as web standards advance.

For technical support regarding system requirements or compatibility questions, please consult our documentation or contact IronGlove Studio® support through your customer portal.

Overview

Installing IronMaps™ follows WordPress standard plugin installation procedures with an added security layer for license verification. As a premium solution developed by IronGlove Studio®, each installation requires manual verification to ensure proper licensing and to provide you with personalized support from our Oregon-based team.

This verification process allows us to maintain the highest standards of security, provide tailored support, and ensure that every IronMaps™ installation receives the attention it deserves. Once approved, you'll receive secure access to download your licensed copy directly from our servers.

Pre-Installation Process

1. Trial Request and Account Setup

After submitting your trial request through our website, our team will review your application and verify your account details. This typically takes 1-2 business days during standard business hours (Pacific Time), but we expect the license approval will most likely be same day. Your trial time will not be impacted and the 14 days will start when we approve you.

2. License Confirmation Email

Once your account has been approved, you will receive an email from IronGlove Studio® containing:

• License confirmation with your unique license key
• Account details including your customer portal access
• Secure download link specifically generated for your installation
• Installation instructions tailored to your license type
• Support contact information for technical assistance

Important: This email will come from an official IronGlove Studio® email address. Please check your spam folder if you don't receive the confirmation within 2 business days of approval. Contact us if you're having difficulties.

3. Secure Download Process

Your confirmation email contains a personalized, time-limited download link that provides secure access to your IronMaps™ plugin file. This link:

• Is unique to your license and cannot be shared
• Expires after 24 hours for security purposes
• Downloads the latest version compatible with your license tier
• Contact support if you need a new download link generated for your account

Installation Steps

Step 1: Download Your Plugin File

1. Open the confirmation email from IronGlove Studio®
2. Click the secure download link provided in your email
3. Save the plugin zip file to your computer

Step 2: Access Your WordPress Admin Dashboard

1. Log in to your WordPress admin dashboard
2. Navigate to Plugins → Add New
3. Click the Upload Plugin button at the top of the page

Step 3: Upload the Plugin

1. Click Choose File and select the plugin zip file you downloaded
2. Click Install Now to begin the installation process
3. Wait for the upload and installation to complete

Step 4: Plugin Activation

1. Once installation is complete, click Activate Plugin
2. You will be redirected to the IronMaps™ welcome screen
3. The plugin will appear in your Plugins list as "IronMaps™"

Verification of Installation

Confirm the installation was successful:

1. Navigate to Plugins → Installed Plugins
2. Verify IronMaps™ shows as "Active"
3. Check IronMaps™ → Dashboard as it should initially show an "Inactive" status
4. In the next section, we'll discuss how to active your installation

Alternative Installation Methods

FTP Installation

If standard upload fails due to file size restrictions:

1. Download and unzip the plugin zip file on your computer
2. Upload the ironmaps folder to /wp-content/plugins/ via FTP
3. Navigate to Plugins in your WordPress admin
4. Locate IronMaps™ and click Activate

Note: If you encounter permission issues, add this line to your wp-config.php file:

define('FS_METHOD', 'direct');

WP-CLI Installation

wp plugin install /path/to/plugin-file.zip --activate

Your IronMaps™ plugin is now successfully installed and ready for use.

Overview

After installing IronMaps™, you must activate your license to unlock full functionality. The license activation process registers your website with IronGlove Studio® and validates your subscription tier.

Activation Process

1. Navigate to IronMaps™ → Settings in your WordPress admin menu
2. Click on the License tab
3. Enter your email address from the confirmation email
4. Enter your license key from the confirmation email
5. Click Activate License
6. Wait for confirmation that your license is active and valid

Your license allows registration of 2 websites: 1 production site and 1 staging site.

Troubleshooting License Issues

"Invalid license key" error

Solutions:

• Verify you copied the complete license key from your email
• Ensure there are no extra spaces before or after the key
• Confirm the email address matches exactly what was provided
• Contact support if the key continues to show as invalid

"License already in use" error

Solutions:

• Each license is limited to 2 sites (production + staging)
• Contact support to transfer or deactivate a previous installation if the dashboard controls won't allow it
• Verify you're not exceeding your site limit

License activation hangs or times out

Solutions:

• Check that your server allows outbound connections
• Verify your site has internet connectivity
• Try again after a few minutes
• Contact support if the issue persists

Verification

Confirm your license is properly activated:

1. Check IronMaps™ → Dashboard
2. Verify status shows "Active"
3. Confirm your license is correctly displayed
4. Note the expiration date, if applicable

Your IronMaps™ license is now active and the plugin is ready for use.

Prerequisites

Your IronMaps™ plugin requires specific Google APIs to deliver full mapping functionality:

• Maps JavaScript API - Powers interactive maps on your website
• Geocoding API - Converts addresses to coordinates and enables location search
• Places API (New) - Allows the application to search, find, and retrieve data points
• Directions API (Optional) - Provides routing and directions functionality

Important: While Google provides generous free tier limits, billing must be enabled even for free usage. Most small to medium websites stay well within the free tier limits.

Step 1: Create Your Google Account

For New Users

If you don't have a Google Account, you can create either a personal or business account:

Personal Google Account

1. Navigate to Google: Visit google.com
2. Sign Up: Click "Sign in" → "Create account" → "For personal use"
3. Account Information:
   • Enter your first and last name
   • Choose a professional email address (consider using your business domain)
   • Create a strong password following Google's requirements
   • Verify with phone number if prompted
4. Complete Setup: Accept terms of service and privacy policy

Business Google Account

For commercial websites and organizations:

1. Navigate to Google: Visit google.com
2. Sign Up: Click "Sign in" → "Create account" → "For business use"
3. Business Information:
   • Enter your business name
   • Choose a business email address (preferably using your domain)
   • Create a strong password with business-grade security
   • Provide business verification information if prompted
4. Business Setup: You may be prompted to set up Google Workspace (optional but recommended for businesses)
5. Complete Setup: Accept business terms of service and privacy policy

For Existing Users

Simply ensure you're signed in to the Google Account you want to use for your maps.

Best Practice: Use a business Google Account for commercial websites to maintain professional organization, billing clarity, and easier team management.

Step 2: Access Google Cloud Console

Initial Setup

1. Open Cloud Console: Navigate to console.cloud.google.com
2. Sign In: Use your Google Account credentials
3. First-Time Setup: Accept Google Cloud terms of service if prompted

Create Your IronMaps™ Project

1. Project Selector: Click the project dropdown at the top of the page (next to the Google Cloud logo)
2. New Project: Click "New Project"
3. Project Configuration:
   • Project Name: Use a descriptive name like "My Website Maps" or your business name
   • Project ID: Google generates a unique ID (editable before creation)
   • Organization/Location: Leave as default unless you have specific requirements
4. Create Project: Click "Create" and wait 1-2 minutes for setup to complete

Step 3: Enable Billing (Required)

Critical Step: Google requires billing to be enabled for all API usage, even within the free tier.

Set Up Billing Account

1. Access Billing: Click the hamburger menu (☰) → "Billing"
2. Create Billing Account: Click "Create account" or "Link a billing account"
3. Account Details:
   • Select your country/region
   • Choose account type: Individual or Business
   • Enter payment information (credit/debit card required)
4. Complete Setup: Follow the prompts to activate your billing account

Understanding Costs

Free Tier Benefits (Monthly):

• Maps JavaScript API: $200 credit = ~28,500 map loads
• Geocoding API: $200 credit = ~40,000 geocoding requests
• Places API (New): $200 credit = ~40,000 search requests
• Directions API: $200 credit = ~40,000 direction requests

Most websites stay well within these limits. Google only charges if you exceed the free tier.

Step 4: Enable Required APIs

You must enable each API individually before use.

Enable Maps JavaScript API

1. API Library: Navigate to "APIs & Services" → "Library"
2. Search: Type "Maps JavaScript API"
3. Select and Enable: Click the API name, then click "Enable"
4. Confirmation: Wait for the "API enabled" confirmation

Enable Geocoding API

1. Search: In the API Library, search for "Geocoding API"
2. Select and Enable: Click the API name, then click "Enable"
3. Confirmation: Verify the API is enabled in your dashboard

Enable Places API (New)

Important: Make sure to enable "Places API (New)" not the legacy Places API.

1. Search: In the API Library, search for "Places API (New)"
2. Select the Correct Version: Look for the one labeled as "(New)" - this is the latest version with better performance and pricing
3. Enable: Click the API name, then click "Enable"
4. Confirmation: Verify it appears in your enabled APIs list

Why Places API (New)?: The new version provides better performance, lower costs, and eliminates the need for separate API calls that the older version required.

Enable Directions API (Optional)

Only enable if your IronMaps™ setup requires routing functionality:

1. Search: Look for "Directions API" in the library
2. Enable: Click to enable if needed for your specific use case

Step 5: Create and Secure Your API Key

Generate API Key

1. Credentials Page: Go to "APIs & Services" → "Credentials"
2. Create Credentials: Click "Create Credentials" → "API Key"
3. Copy Key: Immediately copy the generated API key and store it securely

Retrieving Your Key Later: If you need to access your API key after initial creation:

1. Go to "APIs & Services" → "Credentials"
2. Click on your API key name in the credentials list
3. In the "Additional Information" section, click "Show Key" to reveal your API key
4. Copy the key for use in your IronMaps™ plugin

Secure Your API Key

Critical Security Step: Never leave your API key unrestricted.

1. Edit Restrictions: Click on your newly created API key to edit it
2. Application Restrictions: Choose "HTTP referrers (web sites)"
3. Website Restrictions: Add your domain(s):
   • yourdomain.com/*
   • *.yourdomain.com/*
   • https://yourdomain.com/*
   • https://www.yourdomain.com/*

Development and Testing Setup

If you're developing locally (especially with tools like Lando), you'll need additional referrer restrictions:

For Local Development:

• localhost
• localhost:*
• http://localhost/*
• https://localhost/*
• *.localhost/*
• *.lndo.site/* (for Lando users)

Important: Use HTTP referrer restrictions, not IP address restrictions. IP restrictions don't work with Google Maps JavaScript API.

API Restrictions

Under "API restrictions", select "Restrict key" and choose:

• ✅ Maps JavaScript API
• ✅ Geocoding API
• ✅ Places API (New)
• ✅ Directions API (only if enabled)

Step 6: Create Your Google Map ID (Required)

A Map ID is required for IronMaps™ to function properly. This step unlocks the enhanced features and performance that your maps need.

What is a Map ID?

A Map ID is a unique identifier that connects your map to cloud-based styling and advanced features stored in Google's servers. It enables:

• Better Performance: Up to 66% faster loading times for markers
• Professional Customization: Match your website's branding and colors
• Advanced Features: Enhanced markers, smooth animations, and better user interactions
• Cloud-Based Management: Update map styles without touching your website code

Create Your Map ID

1. Navigate to Map Management: In Google Cloud Console, search for "Maps Management" or look for it under the Google Maps Platform section
2. Create New Map ID: Click "Create Map ID"
3. Configure Your Map:
   • Map Name: Use a descriptive name like "My Business Website Map"
   • Description: Optional, but helpful for organization ("Website maps for [your business name]")
   • Map Type: Select "JavaScript" (this is for web browsers)
   • Map Rendering: Choose "Vector" (recommended for better performance)

Why Choose Vector?

Vector maps provide better performance and enable IronGlove Studio® to deliver advanced features through future plugin updates.

4. Advanced Options (Optional but Recommended):

   • Tilt: Check this box if you want the ability to show 3D building views
   • Rotation: Check this box if you want users to be able to rotate the map view

   Note: You can enable these features now even if you don't plan to use them immediately - it gives you flexibility for the future

5. Create: Click "Create" to generate your Map ID

6. Copy Your Map ID: Once created, copy the Map ID - you'll need this for your IronMaps™ plugin

Customize Your Map Style

After creating your Map ID, you'll be taken to the styling interface. While you can make basic customizations here, most of your map functionality will be controlled through the IronMaps™ admin panel in WordPress. The IronMaps™ plugin is designed to bridge the gap between Google's technical backend and provide you with an easy-to-use interface.

Your styling choices here can influence the overall appearance:

1. Adjust Colors: Change road colors, water colors, and building colors to match your brand
2. Control Points of Interest: Show or hide restaurants, gas stations, tourist attractions, etc.
3. Modify Labels: Control which place names and street names appear
4. Save and Publish: Changes take a few hours to propagate globally

Tip: Start with basic neutral colors that complement your website. The IronMaps™ admin panel will handle most of the complex functionality for you.

Step 7: Configure IronMaps™ Plugin

Add API Key and Map ID to WordPress

1. WordPress Admin: Log in to your WordPress dashboard
2. IronMaps™ Settings: Navigate to your IronMaps™ plugin settings page
3. API Configuration:
   • Google API Key: Enter your restricted API key from Step 5
   • Map ID: Enter your Map ID from Step 6 for enhanced features and performance
4. Save Settings: Save your plugin configuration

Test Your Setup

1. View Maps: Visit a page with your IronMaps™ plugin active
2. Functionality Check:
   • Verify maps display correctly with improved performance (if using Map ID)
   • Test location search functionality (powered by Places API (New))
   • Check any direction features if enabled
   • Look for enhanced marker performance and styling
3. Browser Console: Open developer tools to check for API-related errors
4. Map ID Verification: If you see improved loading performance and enhanced features, your Map ID is working correctly

Step 8: Monitor Usage and Manage Costs

Set Up Usage Monitoring

1. API Dashboard: Go to "APIs & Services" → "Dashboard"
2. View Metrics: Monitor daily and monthly API usage
3. Usage Reports: Review detailed usage reports by API

Configure Usage Alerts

1. Billing Section: Navigate to "Billing" → "Budgets & alerts"
2. Create Budget: Set up budget alerts at 50%, 80%, and 100% of your desired spending limit
3. Alert Notifications: Configure email notifications for budget thresholds

Cost Management Strategies

• Optimize Requests: Avoid unnecessary API calls through efficient plugin configuration
• Set Quotas: Configure daily request limits in the API console
• Regular Reviews: Monitor usage patterns weekly to identify optimization opportunities

Troubleshooting Common Issues

Map Not Loading

Symptoms: Blank map area or "This page can't load Google Maps correctly" error

Solutions:

1. ✅ Verify API key is correctly entered in IronMaps™ settings
2. ✅ Confirm Maps JavaScript API is enabled in Cloud Console
3. ✅ Check that your website domain is listed in API key restrictions
4. ✅ Verify Map ID (if used) is correctly configured and from the same Google Cloud project
5. ✅ Open browser developer console and look for specific error messages
6. ✅ Verify billing is enabled on your Google Cloud account

Location Search Not Working

Symptoms: Address search returns no results or errors

Solutions:

1. ✅ Ensure Places API (New) is enabled (not the legacy Places API)
2. ✅ Verify API key restrictions include Places API (New)
3. ✅ Check for JavaScript console errors
4. ✅ Test with simple, well-known addresses first

Directions Not Functioning

Symptoms: Route calculations fail or return errors

Solutions:

1. ✅ Confirm Directions API is enabled (if your setup requires it)
2. ✅ Verify API key includes Directions API in restrictions
3. ✅ Check that your IronMaps™ configuration actually uses directions functionality

Development and Testing Issues

Symptoms: Maps not loading on localhost or development environments

Solutions:

1. ✅ Switch from IP restrictions to HTTP referrers: IP address restrictions don't work with Google Maps JavaScript API
2. ✅ Add localhost domains: In your API key restrictions, add:
   • localhost
   • localhost:*
   • http://localhost/*
   • https://localhost/*
   • *.localhost/* (for tools like Lando)
   • *.lndo.site/* (specifically for Lando users)
3. ✅ Consider separate development API key: Create a dedicated API key for local development with appropriate localhost restrictions

Note: For WordPress development tools like Lando that create URLs like appname.lndo.site, make sure to include the full wildcard pattern in your HTTP referrer restrictions.

Places API Error Messages

Symptoms: "Places API (New) is not enabled" errors

Solutions:

1. ✅ Check Console: Click the link in your error message or go to your Google Cloud Console
2. ✅ Navigate to APIs & Services > Library
3. ✅ Search for "Places API (New)"
4. ✅ Click Enable
5. ✅ Update API Key: Also add "Places API (New)" to your API key's allowed APIs list

Billing and Usage Issues

Symptoms: Unexpected charges or usage warnings

Solutions:

1. ✅ Review usage reports to identify traffic spikes
2. ✅ Check for bot traffic or unusual activity
3. ✅ Verify API key restrictions are properly configured
4. ✅ Consider implementing additional usage quotas

Security Considerations

Protecting Your Investment

• Regular Audits: Review API key usage and restrictions monthly
• Access Control: Limit who has access to your API keys and billing information
• Monitoring: Set up automated alerts for unusual usage patterns
• Backup Strategy: Keep secure records of your API configuration

WordPress-Specific Security

• Plugin Updates: Keep IronMaps™ updated to the latest version for security patches
• Strong Authentication: Use strong WordPress admin credentials
• Regular Backups: Backup your WordPress site including IronMaps™ configuration
• Security Monitoring: Monitor for suspicious activity on your website

Advanced Configuration

Multiple Environments

Your IronMaps™ license includes support for 1 production website + 1 staging website:

1. Domain Configuration: Both sites can use the same API key with proper domain restrictions
2. Staging Setup: Configure your staging domain (e.g., staging.yourdomain.com or dev.yourdomain.com) in the same API key restrictions
3. Environment Management: Both production and staging sites can share the same Google Cloud project and billing

Advanced Option: For complex setups, you may choose separate Google Cloud projects for production vs staging, though this is typically unnecessary for most IronMaps™ installations.

High-Traffic Websites

For websites expecting high map usage:

1. Usage Forecasting: Estimate monthly API calls based on expected traffic
2. Budget Planning: Set appropriate billing budgets and alerts
3. Performance Optimization: Work with IronGlove Studio® for advanced optimization strategies

Getting Help

IronMaps™ Support

For plugin-specific issues:

• Documentation: Review IronMaps™ plugin documentation
• Support Channels: Contact IronGlove Studio® support

Google Cloud Support

For API or billing issues:

• Google Cloud Console: Use built-in help and support features
• Google Maps Platform: Visit developers.google.com/maps
• Community Forums: Google Cloud and Maps communities

Additional Resources

• Google Cloud Console: console.cloud.google.com
• Google Maps Platform Documentation: developers.google.com/maps
• Places API (New) Documentation: developers.google.com/maps/documentation/places/web-service/overview
• API Security Best Practices: developers.google.com/maps/api-security-best-practices
• Google Cloud Pricing Calculator: cloud.google.com/products/calculator

This guide is current as of 2025. Google occasionally updates their interface and processes, so some specific steps may vary slightly over time.

Overview

The IronMaps™ admin interface is designed from the ground up for real-time feedback and efficient daily workflow management. Unlike traditional WordPress admin pages that require constant page refreshes, IronMaps™ uses a modern React-based dashboard that updates instantly as you work, allowing you to focus on managing your map data rather than waiting for pages to load.

The admin area is organized into six main sections that appear as tabs across the top of your screen:

• Dashboard - System status and quick overview
• Map Points - Create, view, and manage all your map locations
• Metrics - Analytics and performance data (when available)
• Categories & Filters - Organize your content with categories, tags, and custom filters
• Settings - Configure Google APIs, display options, and organizational information
• Account - Manage your subscription, domains, and billing

Accessing Your Admin Interface

First-Time Login

When you first access your IronMaps™ admin interface, you'll land on the Dashboard. The interface is designed to be intuitive, but understanding a few key concepts will help you work more efficiently.

Understanding the Real-Time Interface

Important: IronMaps™ uses a React-based dashboard that updates in real-time. This means:

• No Page Refreshes: Changes appear instantly without reloading the page
• Live Search: Results appear as you type in search boxes
• Instant Updates: Adding, editing, or deleting items updates immediately
• Real-Time Feedback: The interface provides immediate confirmation of your actions

This approach makes daily work much faster and more responsive than traditional web interfaces.

Dashboard Overview

The Dashboard serves as your control center and provides essential information about your IronMaps™ installation at a glance.

License Status Indicator

The most important element on your Dashboard is the license status indicator, which shows:

Active License (Green):

• Green background with checkmark icon
• Displays "Active" status
• Shows your license expiration date
• Indicates all features are available

Expired License (Red):

• Red background with X icon
• Displays "Expired" or "Inactive" status
• Requires license reactivation
• May limit functionality until renewed

Understanding License Status

When your license is active and green, your IronMaps™ installation is fully functional and all features are available.

When your license shows red with an X, you need to re-authenticate your account. This typically happens when:

• Your license has expired and needs renewal
• There's a connectivity issue with the license server
• Your domain registration needs updating

Dashboard Quick Actions

From the Dashboard, you can quickly access the most common tasks:

• Add New Map Point: Jump directly to creating a new location
• View Recent Activity: See your latest map point additions and modifications
• System Status: Check if all required APIs are properly configured
• Quick Settings: Access frequently-used configuration options

Main Navigation

Top Navigation Tabs

The main navigation appears as a horizontal row of tabs across the top of the admin interface. Each tab represents a major section of functionality:

Dashboard: Your starting point and system overview

Map Points: The heart of your mapping system where you manage all locations

Metrics: Analytics and usage statistics (when available)

Categories & Filters: Organizational tools for managing your content

Settings: Configuration options for APIs, display, and business information

Account: Subscription management and domain settings

Navigation Behavior

• Single Click: Switch between sections instantly
• No Loading: Sections load immediately without page refreshes
• State Retention: Your work is automatically saved as you navigate
• Breadcrumb Context: Always know where you are in the system

Getting Oriented: Your First Steps

Step 1: Verify Your License Status

Before diving into creating map points, ensure your Dashboard shows a green license status. If you see red, contact your administrator or IronGlove Studio® support for assistance.

Step 2: Check Your Settings

Visit the Settings tab to verify:

• Google API keys are properly configured
• Your organization information is correct
• Default display settings meet your needs

Step 3: Understand Your Workflow

IronMaps™ follows a logical workflow:

1. Configure Settings (one-time setup)
2. Create Categories (organize your content)
3. Add Map Points (your actual locations)
4. Review and Publish (make points visible on your map)

Step 4: Explore the Interface

Take a few minutes to click through each main tab to familiarize yourself with the available options. The interface is designed to be self-explanatory, with helpful labels and logical organization.

Working with Real-Time Updates

Understanding Instant Feedback

Unlike traditional web applications, IronMaps™ provides immediate visual feedback for all your actions:

Adding Content: New items appear immediately in lists

Editing Information: Changes are reflected instantly across the interface

Deleting Items: Removed items disappear immediately (with confirmation prompts)

Search Results: Filter and search results update as you type

Best Practices for Efficiency

Save Time with Live Search: Start typing in any search box to instantly filter results rather than scrolling through long lists.

Use Bulk Actions: When you need to make changes to multiple items, use the bulk action tools rather than editing items one by one.

Work in Sections: Complete all work in one section before moving to another to maintain context and efficiency.

Trust the System: Changes are saved automatically - you don't need to look for "Save" buttons in most cases.

Interface Elements You'll See Throughout

Common Controls

Search Boxes: Found in most sections, these provide instant filtering as you type

Dropdown Menus: Used for selecting categories, filters, and display options

Toggle Switches: Enable or disable features with a single click

Action Buttons: Clearly labeled buttons for primary actions (Add, Edit, Delete)

Bulk Selection: Checkboxes allow you to select multiple items for group actions

Visual Indicators

Status Icons: Green checkmarks for active/published items, red X for inactive

Loading Indicators: Brief animations show when the system is processing requests

Success Messages: Green notifications confirm when actions complete successfully

Warning Messages: Yellow alerts draw attention to important information

Error Messages: Red notifications indicate when something needs your attention

Confirmation Dialogs

The system will ask for confirmation before performing potentially destructive actions like:

• Deleting map points
• Removing categories that contain content
• Performing bulk actions that affect multiple items

These confirmations help prevent accidental data loss and can be dismissed by clicking the close icon if you change your mind.

Getting Help

Built-in Help Features

Report Bug Button: Located at the bottom of most screens, this allows you to report issues or request features directly to IronGlove Studio®

Contextual Labels: Throughout the interface, descriptive labels and help text provide guidance for each feature

Logical Organization: The interface is organized to match typical workflows, making it easier to find what you need

When You Need Support

If you encounter issues or have questions:

1. Check License Status: Ensure your license is active (green) on the Dashboard
2. Review Settings: Verify your Google API configuration is complete
3. Use Report Bug: Submit specific issues directly through the interface
4. Contact Support: Reach out to IronGlove Studio® for additional assistance

What's Next

Now that you understand the basics of navigating the IronMaps™ admin interface, you're ready to dive into the core functionality. The next chapter will cover Managing Map Points, where you'll learn to create, organize, and maintain the locations that will appear on your interactive map.

Remember: The interface is designed to be intuitive and provide immediate feedback. Don't hesitate to explore and experiment - the system includes safeguards to prevent accidental data loss, and you can always undo changes if needed.

This guide covers the current IronMaps™ admin interface. IronGlove Studio® regularly updates the system with new features and improvements, so some interface elements may evolve over time.

Overview

Map Points are the core of your IronMaps™ system - they represent the actual locations that will appear on your interactive map. Whether you're plotting business locations, resources, events, or any other type of geographic data, the Map Points section is where you'll spend most of your time managing your mapping content.

The Map Points interface is designed for efficiency, allowing you to view, search, organize, and modify large numbers of locations quickly without constant page refreshes.

Understanding Map Points

What Are Map Points?

Map Points are individual locations on your map that can represent:

• Business Locations: Stores, offices, service locations
• Resources: Community resources, facilities, services
• Events: Conferences, meetings, temporary locations
• Products: Retail locations, distribution points
• Members: Member businesses, partner organizations
• Any Geographic Data: Essentially any location that has an address or coordinates

Map Point Status

Each Map Point can have different status levels:

Published: Active and visible on your public map

Unpublished: Created but not visible to public users

Draft: Work in progress, not ready for public viewing

Accessing the Map Points Screen

Navigate to the Map Points tab in your admin interface to view all your map points regardless of their type or status. This central hub displays all your locations in an organized, searchable format.

Initial View

When you first access Map Points, you'll see:

• List of Current Points: All existing map points in a sortable table
• Display Controls: Options to show more or fewer points per page
• Search Interface: Real-time search capabilities in the upper left
• Filter Options: Category and advanced filtering controls
• Action Buttons: Tools for adding new points and bulk operations

Display Settings

Points Per Page: By default, the system shows 10 map points per page. You can adjust this using the dropdown in the upper-right corner (located under the "Add New Point" button) to show more or fewer points based on your workflow needs.

Why Limit Display?: For websites with hundreds or thousands of map points, limiting the initial display improves page load times and makes the interface more manageable.

Searching Your Map Points

Real-Time Search

The search functionality in Map Points provides instant results as you type, making it easy to find specific locations quickly.

Location: Upper-left corner of the Map Points screen

How It Works: Start typing any part of a map point's information - name, address, description, or other details

Real-Time Results: Points are filtered instantly as you type, without waiting for page loads

Partial Matching: You don't need to type complete words - partial matches will appear

Search Tips

Use Partial Terms: Type "coffee" to find all coffee shops, or "main" to find all locations on Main Street

Multiple Words: The search looks across all map point fields, so "restaurant" will find all points with the label "restaurant" in the database

Clear Search Results: To reset and show all points again, simply clear the search box and press Enter

Search Best Practices

Start Broad: Begin with general terms and narrow down as needed

Try Different Keywords: If you don't find what you're looking for, try alternate terms

Use Location Details: Search by street names, zip codes, or neighborhood names 

Organizing with Categories

Category Filtering

Categories provide a powerful way to organize your map points into logical groups that reflect your business structure or use case.

All Categories View: Shows every map point regardless of category assignment

Specific Category View: Filters to show only points in selected categories

Category Dropdown: Located near the search box for quick category switching

Common Category Examples

By Business Type:

• Retail Locations
• Service Centers
• Distribution Points
• Corporate Offices

By Geographic Region:

• North Region
• South Region
• Urban Locations
• Rural Locations

By Product Line (for businesses with multiple offerings):

• Electronics Retailers
• Automotive Dealers
• Food Service Partners
• Wholesale Distributors

By Membership Level (for organizations):

• Premium Members
• Standard Members
• Partner Organizations
• Affiliate Locations

Working with Categories

Quick Filtering: Select a category from the dropdown to instantly filter your map points

Visual Organization: Categories help you mentally organize large numbers of locations

Workflow Efficiency: Focus on one category at a time for bulk updates or maintenance

Public Display: Categories can also be used for filtering on your public map

Advanced Filtering with Show Filters

Accessing Advanced Filters

Next to the Categories dropdown, you'll find a Show Filters button that reveals additional filtering options for more granular organization and searching.

Available Filter Types

Tags: Fine-grained organizational labels for detailed categorization

Center Points: Specialized location types for specific use cases

Understanding Tags

Tags work similarly to WordPress tags and provide more specific, detailed organization than categories.

Purpose: Tags allow for drill-down searches and cross-category organization

Multiple Tags: Each map point can have multiple tags for flexible categorization

Search Enhancement: Tags make it easier to find specific types of locations across different categories

Example Tag Usage:

• Service Features: "Drive-through", "24-hour", "Wheelchair accessible"
• Specialties: "Organic", "Local", "Certified", "Award-winning"
• Seasonal: "Summer hours", "Holiday location", "Seasonal service"
• Customer Types: "Family-friendly", "Business customers", "Wholesale only"

Understanding Center Points

Center Points represent locations on your map where resources, members, products, and other data points are concentrated for your particular use case.

Purpose: Help identify key geographic areas or hubs in your network

Strategic Planning: Useful for understanding coverage areas and service gaps

Resource Allocation: Identify where to focus marketing, support, or expansion efforts

Example Center Point Usage:

• Service Areas: Central locations that serve surrounding regions
• Distribution Hubs: Points where products are distributed to surrounding retailers
• Resource Centers: Locations where community resources are concentrated
• Membership Clusters: Areas with high concentrations of member organizations

Using Advanced Filters

Combine Filters: Use categories, tags, and center points together for precise searching

Save Time: Advanced filters help you quickly isolate specific groups of locations

Bulk Operations: Filter to target specific groups for bulk updates or maintenance

Analysis: Use filters to analyze patterns in your location data

Bulk Actions

Understanding Bulk Operations

When you need to make changes to multiple map points at once, bulk actions provide an efficient alternative to editing locations one by one.

Available Bulk Actions

Delete: Remove multiple map points permanently Publish: Make multiple unpublished points visible on your public map Unpublish: Hide multiple published points from your public map

How to Use Bulk Actions

1. Select Points: Use the checkboxes next to each map point to select multiple items
2. Choose Action: Select your desired bulk action from the dropdown menu
3. Confirm Action: The system will ask you to confirm before proceeding
4. Safety Check: You can cancel by clicking the close icon if you change your mind

Bulk Action Best Practices

Start Small: Test bulk actions with a few items before applying to large groups

Use Filters First: Filter your list to show only the points you want to modify

Double-Check Selection: Review your selected items before confirming bulk actions

Backup Important Data: For large bulk deletions, consider exporting your data first

Safety Features

Confirmation Dialogs: The system always asks for confirmation before bulk operations

Clear Communication: Dialogs clearly explain what will happen to your selected points

Cancel Option: You can always back out of a bulk action before it's executed

Immediate Feedback: The interface updates instantly to show the results of your actions

Adding New Map Points

Quick Access

The Add New Point button is prominently located in the upper-right corner of the Map Points screen for easy access whenever you need to create a new location.

New Point Workflow

When you click "Add New Point", you'll be taken to a form where you can enter:

Basic Information:

• Point name or title
• Address or coordinates
• Description or details
• Contact information

Organization:

• Category assignment
• Tag selection
• Center point designation (if applicable)

Display Options:

• Publication status
• Visibility settings
• Map pin customization

Planning Your Map Points

Before Adding Multiple Points:

• Set up your categories first for consistent organization
• Plan your tagging strategy for easy searching later
• Consider your center point strategy if applicable
• Understand your workflow for efficient data entry

Managing Existing Map Points

Editing Individual Points

Quick Edit: Click the pencil icon next to any map point for immediate editing

Full Edit: Access complete editing options from the detailed view

Real-Time Updates: Changes appear immediately throughout the interface

Point Status Management

Publishing Control: Easily switch points between published and unpublished status

Visibility Options: Control which points appear on your public map

Status Indicators: Visual cues show the current status of each point

Organizing and Maintenance

Regular Review: Periodically review your map points for accuracy and relevance

Category Updates: Adjust category assignments as your organization grows

Tag Maintenance: Keep tags consistent and meaningful for easy searching

Bulk Updates: Use bulk actions for efficiency when making widespread changes

Best Practices for Map Point Management

Organizational Strategy

Consistent Naming: Develop and stick to naming conventions for your map points

Logical Categories: Create categories that reflect how your users will search

Meaningful Tags: Use tags that add real value for searching and filtering

Regular Maintenance: Schedule periodic reviews to keep your data current

Efficiency Tips

Use Search First: Before scrolling through long lists, try searching

Filter Before Bulk Actions: Narrow your view before making bulk changes

Work in Batches: Process similar types of updates together for efficiency

Plan Your Categories: Set up organizational structure before adding many points

Data Quality

Accurate Addresses: Ensure addresses are complete and correctly formatted

Complete Information: Fill in all relevant fields for better user experience

Regular Updates: Keep contact information and details current

Test Your Points: Periodically check that your map points display correctly on your public map

What's Next

Now that you understand how to manage map points effectively, the next chapter will cover Analytics and Metrics, where you'll learn to track usage and performance of your mapping system to optimize your content and understand how your audience interacts with your map.

Remember: The Map Points section is designed for efficiency and real-time updates. Take advantage of the search and filtering capabilities to work with your data effectively, and don't hesitate to use bulk actions when appropriate to save time on routine maintenance tasks.

This guide covers the current Map Points functionality in IronMaps™. Features and interface elements may be updated over time to improve functionality and user experience.

The metrics section currently provides fixed visual charts showing data breakdowns for industries, center points, categories, and other organizational elements in your IronMaps™ system. While these charts offer valuable insights into your data distribution and help you understand patterns in your map content, the visualization options are not yet configurable. This preview functionality gives you a solid grasp of your mapping data, but full-featured analytics with customizable reporting are still in development.

Overview

The Categories & Filters section is your organizational command center for IronMaps™. This powerful system allows you to create hierarchical structures, detailed tagging systems, and specialized filters that help both you and your map users find exactly what they're looking for quickly and efficiently.

The organizational approach is designed to emulate familiar WordPress methods of managing categories and tags, while also providing specialized tools for center points, industries, communities, and certification tracking. Whether you're managing a simple business directory or a complex multi-faceted organization, this system scales to meet your needs.

Understanding the Organization System

Why Organization Matters

Proper organization serves multiple purposes:

For Administrators: Easy management and maintenance of large numbers of map points

For Users: Intuitive filtering and searching on your public map

For Analytics: Better data segmentation and performance tracking (when metrics are fully available, currently in development)

For Growth: Scalable structure that accommodates expansion

Types of Organizational Tools

Categories: Primary organizational structure, hierarchical like folders

Tags: Flexible cross-cutting labels for detailed classification

Center Points: Geographic or strategic focal areas

Industries: Business sector classifications with pre-built options

Communities: Demographic or community-based classifications

COBID: Certification tracking (Oregon-specific, expandable to other states)

Accessing Categories & Filters

Navigate to the Categories & Filters tab in your admin interface. This section is organized into separate areas for each type of organizational tool, allowing you to manage different aspects of your classification system independently.

Interface Layout

The Categories & Filters section uses a consistent two-column layout throughout:

Left Column: Creation and editing interface for new items

Right Column: List of existing items with management controls

Consistent Controls: Edit (pencil icon) and delete (X icon) for all item types

Bulk Actions: Available for all organizational tools with the same confirmation system used elsewhere

Working with Categories

Understanding Categories

Categories in IronMaps™ work similarly to folder systems or WordPress categories. They provide the primary organizational structure for your map points and can be hierarchical (categories within categories).

Creating New Categories

Location: Left side of the Categories section Access: Look for "Create New Category" interface

Required Information

Category Name: The display name that will appear in your interface and on your public map

Slug: A URL-friendly version of the category name

• Auto-Generation: If you leave the slug field blank, the system automatically creates one following standard web conventions
• How Slugs Work: The system converts your category name to lowercase, replaces spaces with hyphens, and removes special characters
• Example: "Coffee Shops & Cafes" becomes "coffee-shops-cafes"
• Custom Slugs: You can override the automatic slug if you need specific URL formatting

Parent Category: Select an existing category to create a hierarchical structure

• Top-Level: Leave blank to create a main category
• Sub-Category: Select a parent to create categories within categories
• Hierarchy Benefits: Allows logical grouping like "Restaurants" > "Fast Food" > "Pizza"

Description: Optional detailed explanation of what belongs in this category

• Admin Reference: Helps maintain consistency when multiple people manage the system
• User Display: May be used in public-facing category listings depending on your theme
• SEO Benefits: Can improve search engine understanding of your content

Visual Customization

Category Icon: Upload a custom icon that represents this category

• Display Location: Icons appear across the top of the category menu on your public map
• Format Recommendations: Use consistent icon style and size for professional appearance
• Purpose: Visual cues help users quickly identify and select relevant categories

Category Color: Choose a distinctive color for this category

• Consistency: Use colors that align with your brand or create a logical color-coding system
• User Experience: Colors help users navigate and understand your organizational system
• Map Integration: Colors may be used for map pins or interface elements

Managing Existing Categories

Categories List: Right-hand column shows all existing categories

Edit Function: Click the pencil icon to modify any category

Delete Function: Click the X to remove a category (with confirmation)

Bulk Actions: Select multiple categories for group operations

Editing Considerations

Impact Assessment: Consider how changes affect existing map points assigned to this category

Hierarchy Changes: Moving a category in the hierarchy affects all its sub-categories

Color/Icon Updates: Visual changes are reflected immediately across your public map

Working with Tags

Understanding Tags

Tags provide flexible, cross-cutting classification that works alongside your category system. While categories are hierarchical and exclusive (like folders), tags are non-hierarchical and can be applied in any combination (like labels).

Tag Strategy

Complementary to Categories: Tags add detail that doesn't fit in your main category structure

Multiple Assignment: Each map point can have multiple tags

Cross-Category: Tags can span across different categories for flexible organization

User Filtering: Tags often become filter options on your public map

Creating and Managing Tags

Interface: Similar to categories but simplified Required Fields:

• Name: The tag label
• Slug: Auto-generated or custom URL-friendly version
• Parent: Optional hierarchical organization (less common than with categories)
• Description: Optional explanation of tag usage

Management: Same edit/delete controls as categories List View: Right column shows all existing tags with bulk action capabilities

Tag Best Practices

Consistent Naming: Develop standards for tag names to avoid duplicates like "kid-friendly" and "family-friendly" Meaningful Tags: Use tags that genuinely help users find what they need Regular Review: Periodically clean up unused or redundant tags Strategic Thinking: Consider how tags will be used for filtering on your public map

Working with Center Points

Understanding Center Points

Center Points are specialized location designations that identify key geographic areas or strategic focal points in your mapping system. They're particularly useful for organizations with service areas, distribution networks, or resource concentration patterns.

Center Point Applications

Service Coverage: Central locations that serve surrounding geographic areas

Resource Distribution: Hubs where services, products, or resources are concentrated

Strategic Planning: Important locations for business development or expansion

Community Focus: Areas where your organization has particular presence or impact

Creating Center Points

Interface: Identical to tags - left side for creation, right side for management Fields Available:

• Name: Descriptive name for this center point
• Slug: Auto-generated URL-friendly identifier
• Parent: Optional hierarchical organization
• Description: Details about what makes this a center point

Center Point Strategy

Geographic Logic: Choose center points based on actual geographic or strategic importance

Reasonable Number: Don't create too many center points - they should represent truly significant locations

Clear Purpose: Each center point should have a clear reason for existence

User Value: Consider whether center points will be meaningful to your map users

Working with Industries

Understanding Industry Classification

The Industries system provides standardized business sector classification, with IronGlove Studio® providing a curated list of the top 20 industry categories based on research from membership-based organizations like Chambers of Commerce.

Default Industry Setup

Pre-Built Options: IronMaps™ includes carefully selected industry categories covering the most common business types

Research-Based: Categories are derived from analysis of hundreds of industry classifications from membership organizations

Comprehensive Coverage: The default list covers variations and specializations within major industry sectors

Ongoing Updates: The logic and categories are updated as industries evolve

Industry Management Options

Accept Defaults: Use the pre-built industry list for immediate functionality

Customize List: Add, edit, or remove industry categories to match your specific needs

GrowthZone Integration: The system works in conjunction with GrowthZone for enhanced membership management when importing, we plan to improve this over time and add additional SaaS-based member management systems.

When to Use Default Industries

Membership Organizations: Chambers of Commerce, business associations, networking groups

Business Directories: General business listings covering multiple sectors

Economic Development: Organizations tracking business diversity and growth

Quick Setup: When you need industry classification immediately without custom development

Customizing Industries

Add Specialized Categories: Include industry segments specific to your region or focus

Remove Irrelevant Sectors: Delete categories that don't apply to your organization

Modify Descriptions: Adjust category descriptions to match your terminology

Create Hierarchies: Organize industries into logical parent-child relationships

Working with Communities

Understanding Community Classifications

Communities provide demographic, social, or mission-based classification options that help organizations track diversity, compliance, and community engagement goals.

Default Community Options

Pre-Built Classifications: Common community designations used by non-profits, membership organizations, and NGOs

Compliance-Ready: Categories designed to support compliance reporting standards

Inclusive Options: Broad range of community identifiers for diverse organizations

Common Community Classifications

Business Ownership: Veteran-Owned, Women-Owned, Minority-Owned, Family-Owned

Certification Status: Certified, Verified, Accredited, Licensed

Community Focus: Local, Regional, National, International

Mission Alignment: Non-Profit, B-Corp, Social Enterprise, Community-Focused

Community Management

Accept Defaults: Use pre-built community classifications for immediate compliance capability

Edit as Needed: Modify the list to match your organization's specific community focus

Compliance Tracking: Use for maintaining required diversity and inclusion reporting

Grant Requirements: Support grant applications that require community engagement documentation

When Community Classifications Are Most Valuable

Non-Profit Organizations: Tracking community impact and diversity goals

Membership Organizations: Demonstrating inclusive membership and community representation

NGOs: Meeting grant requirements and compliance standards

Government Partnerships: Supporting public sector diversity and inclusion initiatives

Working with COBID Classifications

Understanding COBID

COBID (Certification Office for Business Inclusion and Diversity) classifications are Oregon-specific certification designations that help track business diversity and inclusion compliance.

Oregon Focus: Currently designed for Oregon-based organizations

Expansion Plans: IronGlove Studio® plans to add similar classifications for other states

Interface Evolution: The interface for this section may change as additional states are added

COBID Implementation

Oregon Organizations: Use the default COBID classifications if your organization operates in Oregon

Other States: Leave this setting as "No" if COBID doesn't apply to your organization

Future Planning: Consider whether similar certifications in your state would be valuable

Managing COBID Classifications

Default List: Accept pre-built COBID categories for immediate compliance tracking

Customization: Add, edit, or delete categories as needed for your specific requirements

Not Required: This classification system is entirely optional based on your organizational needs

Organizational Strategy Best Practices

Planning Your Structure

Start with Categories: Establish your main category structure before adding detailed tags

User Perspective: Consider how your map users will want to search and filter

Administrative Efficiency: Create systems that make ongoing management easier

Growth Accommodation: Plan for expansion and additional complexity over time

Consistency Guidelines

Naming Conventions: Develop and document standards for naming categories, tags, and other classifications

Hierarchy Logic: Use consistent principles for organizing hierarchical structures

Regular Maintenance: Schedule periodic reviews to maintain organizational quality

Team Training: Ensure all team members understand the organizational strategy

Integration Considerations

Public Map Display: Consider how your organizational structure will appear to map users

Search Optimization: Use classifications that match how people naturally search for information

Analytics Preparation: Well-organized content provides better analytics when metrics are fully available

Future Features: Organized content is ready to take advantage of new IronMaps™ capabilities as they're released

What's Next

The next chapter will cover Settings and Configuration, where you'll learn to configure Google APIs, set display preferences, manage business information, and customize the technical aspects of your IronMaps™ installation.

A solid organizational foundation, established in this chapter, makes the configuration choices in Settings more meaningful and effective.

This organizational system is designed to grow with your needs. Start simple and add complexity as your mapping system expands and your requirements become more sophisticated.

Overview

The Settings section is your technical control center for IronMaps™, where you configure everything from Google API integration to visual appearance and organizational information. Proper configuration ensures your maps function correctly, look professional, and provide the best possible experience for your users.

Most settings need to be configured only once during initial setup, though you may return periodically to update business information or adjust display preferences as your needs evolve.

Important Note: The settings are presented in a logical configuration order rather than the exact sequence they appear in the interface. This approach helps ensure you complete setup efficiently and understand dependencies between different settings.

Accessing Settings

Navigate to the Settings tab in your admin interface to access all configuration options. The settings are organized into logical groups covering API integration, display preferences, business information, and data management.

Google API Configuration

Google API Key

Purpose: Enables core map functionality including displaying interactive maps and calculating addresses from coordinates.

Required For:

• Interactive map display on your website
• Address geocoding (converting addresses to map coordinates)
• Location search functionality
• Distance calculations and routing

Setup Process: If you haven't already configured your Google API key, refer to the detailed IronMaps™ Google API Setup Guide for complete step-by-step instructions on:

• Creating a Google Cloud project
• Enabling required APIs
• Generating and securing your API key
• Setting proper restrictions for security

Security Considerations:

• Never share your API key publicly
• Use domain restrictions to limit where the key can be used
• Monitor usage through Google Cloud Console
• Rotate keys periodically for enhanced security

Google Maps ID

Purpose: The Google Maps ID provides access to advanced Google Maps Platform features and allows you to customize your map's visual appearance through Google's Map Styling interface.

What It Enables:

• Advanced Features: Access to the full range of Google Maps JavaScript API capabilities
• Custom Styling: Control over map colors, road styles, labels, and visual elements
• Enhanced Performance: Optimized map loading and rendering
• Feature Consistency: Ensures compatibility with all Google Maps Platform features

How to Use Map Styling:

1. Access Google Cloud Console: Navigate to your Google Cloud project
2. Find Map Management: Go to Google Maps Platform → Map Management
3. Select Your Map ID: Choose the Map ID you've configured in IronMaps™
4. Customize Appearance: Use Google's visual styling tools to:
   • Adjust color schemes to match your brand
   • Control the visibility of roads, labels, and landmarks
   • Set custom colors for water, parks, and other geographic features
   • Create light or dark themes

Configuration Steps:

• Create a Map ID in your Google Cloud Console
• Configure styling options through Google's interface
• Enter the Map ID in your IronMaps™ settings
• Test the appearance on your live website

Benefits of Custom Styling:

• Brand Consistency: Match your map appearance to your website's design
• User Experience: Create maps that feel integrated with your overall site design
• Accessibility: Adjust colors and contrast for better readability
• Professional Appearance: Stand out from default Google Maps styling

Display Settings

Default Zoom Level

Purpose: Controls how closely zoomed your map appears when users first view it.

Recommended Setting: Zoom level 7 provides a good balance for most use cases

Customization: Adjust based on your specific needs:

• Higher Numbers (10-15): Closer zoom, good for city-level or neighborhood maps
• Lower Numbers (3-6): Wider view, good for state-level or regional maps
• Consider Your Coverage: Match zoom level to the geographic spread of your map points

Testing Your Zoom Level:

• Preview your map after setting the zoom level
• Consider how it looks with your typical grouping of map points
• Test on both desktop and mobile devices
• Adjust if users frequently need to zoom in or out immediately

Map Pin Size

Purpose: Controls the visual size of markers that represent your map points.

Available Options:

• Small: Recommended for maps with many closely-spaced points
• Medium: Good balance for most applications
• Large: Best for maps with fewer points or when showcasing images

Choosing Pin Size:

• Small Pins: Ideal for dense urban areas or resource directories with many locations
• Medium Pins: Versatile option that works well for most business applications
• Large Pins: Perfect for featured locations, product showcases, or when using custom pin images

Visual Considerations:

• Density: Smaller pins work better when you have many points close together
• User Experience: Larger pins are easier to click on mobile devices
• Content Type: Large pins work well when representing products with images

Map Container Size

Purpose: Controls what percentage of the screen height your map occupies.

Default Setting: 70% of screen height

Customization Range: Adjust based on your page layout and user needs

Considerations for Container Size:

• Content Balance: Larger maps provide more exploration space but leave less room for other page content
• Mobile Experience: Consider how the size works on smaller screens
• User Behavior: Analytics can help determine if users interact more with larger or smaller map displays
• Page Layout: Coordinate with your overall page design and navigation

Default Filter Configuration

Add Default Community Filters

Purpose: Provides pre-built filtering options for community-based classifications commonly used by non-profits, membership organizations, and NGOs.

When to Enable: Choose "Yes" if your organization needs to:

• Track diversity and inclusion metrics
• Maintain compliance reporting standards
• Support community engagement goals
• Demonstrate inclusive membership

What's Included: Standard community classifications such as:

• Veteran-Owned businesses
• Women-Owned enterprises
• Minority-Owned companies
• Other community-focused designations

Benefits:

• Quick Setup: Immediately adds mainstream community filters without manual creation
• Compliance Ready: Supports common reporting requirements
• Standardization: Uses widely recognized classification standards
• Expandable: You can edit the list after installation to match specific needs

When to Choose "No": If community classifications don't apply to your use case or if you prefer to create custom classifications from scratch.

Add Default Industry Filters

Purpose: Provides a curated list of the top 20 industry categories derived from research of membership-based organizations like Chambers of Commerce.

What's Included: Comprehensive industry classifications covering:

• Major business sectors and their variations
• Common specializations within industries
• Categories that accommodate business diversity
• Frequently-used industry classifications from Chamber of Commerce data

Benefits:

• Research-Based: Categories are based on analysis of hundreds of real-world industry classifications
• Comprehensive Coverage: Includes variations and specializations to avoid gaps
• Proven Effectiveness: Classifications tested across multiple membership organizations
• Time-Saving: Eliminates the need to research and create industry categories manually

Integration Features:

• GrowthZone Compatibility: Works in conjunction with GrowthZone membership management systems
• Customizable: You can modify the list after installation to better match your specific needs
• Expandable: Add additional industry categories as your organization grows

When to Enable: Choose "Yes" for:

• Business directories and membership organizations
• Economic development organizations
• Chambers of Commerce and business associations
• Any organization that categorizes businesses by industry

When to Choose "No": If you have highly specialized industry needs or prefer to create a completely custom industry classification system.

Add Default COBID Filters

Purpose: Provides Oregon-specific COBID (Certification Office for Business Inclusion and Diversity) certification classifications.

Current Scope: Designed specifically for Oregon-based organizations

Future Expansion: IronGlove Studio® plans to add similar certifications for other states

When to Enable: Choose "Yes" if:

• Your organization operates in Oregon
• You need to track COBID certifications
• Diversity certification tracking is important for your compliance or reporting needs

When to Choose "No":

• If your organization doesn't operate in Oregon
• If COBID certifications aren't relevant to your use case
• If you prefer to wait for your state's specific certifications to be added

Interface Evolution: The interface for this section may change as additional state certifications are added to the system.

Business Information Settings

Organization Name

Purpose: Your company or organization's name used throughout the system for SEO and display purposes.

Usage:

• Displayed in map interface elements
• Used in search engine optimization
• Appears in exported data and reports
• Integrated into public-facing map elements

Best Practices:

• Use your official business name
• Maintain consistency with other marketing materials
• Consider how it will appear in various contexts
• Update if your organization name changes

Organization Description

Purpose: A description of your organization that gets injected into your website for on-page SEO benefits.

SEO Impact:

• Helps search engines understand your organization's purpose
• Can improve local search rankings
• Provides context for your map content
• Supports overall website SEO strategy

Writing Guidelines:

• Keep it concise but descriptive
• Include relevant keywords naturally
• Focus on what makes your organization unique
• Avoid keyword stuffing - write for humans first

Content Suggestions:

• Brief explanation of your mission or services
• Geographic area you serve
• Key industries or communities you support
• Unique value proposition

Organization Logo

Purpose: Your organization's logo for display in SEO-enhanced map interfaces and potentially in public-facing map elements.

Technical Requirements:

• Use high-quality image files (PNG or JPG)
• Ensure logo works at various sizes
• Consider how it appears on different background colors
• Optimize file size for web performance

Usage Contexts:

• Search engine result displays
• Map interface branding
• Exported materials and reports
• Mobile app displays (if applicable)

Address Section

Purpose: Your organization's physical address used for local SEO and business verification.

Required Information:

• Street Address: Complete street address including suite/unit numbers
• City: Full city name
• State: State or province
• Zipcode: Complete postal code

SEO Benefits:

• Improves local search rankings
• Supports Google My Business integration
• Enhances local directory listings
• Provides geographic context for your content

Accuracy Importance:

• Ensure address matches other online listings
• Use official USPS formatting when possible
• Keep information current if you relocate
• Consider P.O. Box limitations for local SEO

Organization Social Media

Purpose: Links to your organization's social media profiles for integration into on-page SEO with schema markup.

Platform Integration:

• Mainstream Platforms: Support for major social media networks
• Schema Markup: Automatically integrated into your website's SEO structure
• Future Expansion: Additional platforms will be added over time

SEO Benefits:

• Enhances search engine understanding of your organization
• Supports social media profile verification
• Improves overall online presence consistency
• Can boost local search rankings

Best Practices:

• Use complete URLs (including https://)
• Ensure profiles are active and regularly updated
• Maintain consistent branding across platforms
• Only include profiles you actively maintain

Data Management

Import IronMaps Data

Purpose: Allows you to restore a complete map configuration from a previously exported dataset.

When to Use:

• Site Migration: Moving your map to a new website or server
• Backup Restoration: Recovering from data loss or corruption
• Template Deployment: Setting up multiple similar maps
• Development Testing: Loading test data for development purposes

Data Included in Imports:

• All map points and their details
• Category and tag structures
• Organizational settings and preferences
• Filter configurations and customizations

Import Process:

1. Prepare Data File: Ensure you have a valid IronMaps™ export file
2. Access Import Tool: Navigate to the Import section in Settings
3. Upload File: Select and upload your data file
4. Review Preview: Confirm the data looks correct before importing
5. Execute Import: Complete the import process
6. Verify Results: Check that all data imported correctly

Important Considerations:

• Backup First: Always backup your current data before importing
• Data Conflicts: Understand how imports handle existing data
• Testing Recommended: Test imports on staging sites when possible
• File Format: Only import files exported from IronMaps™ systems

Configuration Best Practices

Initial Setup Checklist

1. Google APIs: Configure API key and Map ID first
2. Display Settings: Set zoom level and pin size appropriate for your content
3. Default Filters: Choose appropriate default filter sets for your organization type
4. Business Information: Complete all organizational details for SEO benefits
5. Test Configuration: Preview your map to ensure everything works correctly

Ongoing Maintenance

Regular Reviews: Periodically review settings to ensure they still meet your needs

Business Updates: Keep organizational information current

Performance Monitoring: Check that Google API usage stays within budget

Security Checks: Verify API key restrictions remain appropriate

Troubleshooting Configuration Issues

Map Not Displaying: Verify Google API key is correct and has proper restrictions

Styling Problems: Check that Google Maps ID is properly configured

Performance Issues: Review zoom level and pin size settings

SEO Concerns: Ensure all business information is complete and accurate

What's Next

The final chapter will cover Account Management, where you'll learn to manage your IronMaps™ subscription, configure allowed domains, handle billing through the Stripe Portal, and use the built-in bug reporting system to communicate with IronGlove Studio® support.

Proper settings configuration, as covered in this chapter, provides the foundation for reliable account management and ongoing system maintenance.

Settings configuration is typically a one-time setup process, though you may return periodically to update business information or adjust display preferences as your organization evolves.

Overview

The Account section is your subscription management center, where you can monitor your IronMaps™ license status, manage authorized domains, handle billing through secure Stripe integration, and communicate directly with IronGlove Studio® support. This section ensures your mapping system stays properly licensed and provides direct channels for getting help when needed.

Account management is typically handled by administrators or site owners, as it involves subscription details and billing information that affect the entire IronMaps™ installation.

Accessing Account Management

Navigate to the Account tab in your admin interface - the final item in the main navigation menu. The Account section provides a comprehensive view of your subscription status and management tools.

Account Overview

When you access the Account section, you'll see:

• Current subscription status and expiration information
• Domain management for your authorized installations
• Billing management through secure Stripe Portal integration
• Direct support communication via the Report Bug system

Subscription Status and Management

Understanding Your License

License Overview: Your IronMaps™ license includes support for specific domain configurations designed to meet typical business needs while maintaining security and proper usage tracking.

Included Coverage: Each IronMaps™ license supports:

• One Production Website: Your live, public-facing website
• One Staging Website: Your development or testing environment

This dual-domain approach supports professional web development workflows while ensuring proper license compliance.

Account Status Display

Active Status Indicators:

• Subscription Status: Shows whether your license is current and active
• Expiration Date: Clear display of when your subscription expires
• Renewal Information: Guidance on renewal processes and timing
• License Health: Overall status of your IronMaps™ installation

Status Monitoring: The account status information is also reflected in the Dashboard's license indicator, providing consistent status awareness throughout the system.

Subscription Expiration Management

Advance Notice: The system provides advance warning before your subscription expires

Renewal Process: Clear instructions for renewing your subscription before interruption

Grace Period: Understanding of any grace period policies

Reactivation: Process for reactivating expired subscriptions

Domain Management

Understanding Allowed Domains

Your IronMaps™ license includes authorization for two specific domains, supporting a professional development workflow:

Primary Domain: Your live, production website where customers or users access your map

Secondary Domain: Your staging, development, or testing environment

Managing Your Domains

Domain Registration: Use the Account section to register and manage your authorized domains

Domain Changes: Update domain registrations when you migrate sites or change hosting

Development Workflow: Leverage the two-domain allowance for safe development and testing

Common Domain Configurations

Typical Setup Examples:

• Production: www.yourbusiness.com + Staging: staging.yourbusiness.com
• Production: yourdomain.com + Development: dev.yourdomain.com
• Production: Main site + Testing: test.yourdomain.com

Flexibility: The system accommodates various domain structures to match your specific hosting and development needs.

Changing Authorized Domains

When You Might Need Changes:

• Website migration to new hosting
• Domain name changes for rebranding
• Development environment relocations
• Hosting provider switches

Change Process:

1. Access Domain Management: Navigate to the domain section in Account settings
2. Update Registration: Enter your new domain information
3. Confirm Changes: Verify the new domain configuration
4. Test Installation: Ensure IronMaps™ functions correctly on the new domain

Important Considerations:

• Timing: Plan domain changes during low-traffic periods
• Testing: Always test new domains before making them live
• DNS Propagation: Allow time for DNS changes to propagate globally
• Backup Planning: Maintain access to previous domains during transitions

Billing Management Through Stripe Portal

Secure Billing Integration

IronMaps™ uses Stripe, a leading payment processor, to handle all billing and subscription management securely. This approach ensures:

Security: Your payment information is handled by PCI-compliant systems

Privacy: IronGlove Studio® never stores your billing information directly

Reliability: Industry-standard payment processing with high uptime

Flexibility: Support for various payment methods and international transactions

Account Details Configuration

Before accessing billing management, you need to set up your Account Details:

Required Information:

• Email Address: Must match the email used for your original IronMaps™ purchase
• Generated Password: System-provided password for Stripe Portal access

Setup Process:

1. Enter Email: Use the same email address associated with your IronMaps™ purchase
2. Save Information: Save your account details first
3. Access Stripe Portal: Click the Stripe Portal link to open billing management

Critical Requirement: The email address must exactly match the account used for your original purchase. Mismatched emails will prevent access to billing management.

Using the Stripe Portal

Access Method: After configuring your account details, click the "Stripe Portal" link to open a secure billing management interface.

Available Functions:

• View Payment History: Complete record of all payments and invoices
• Update Payment Methods: Change credit cards or payment sources
• Download Invoices: PDF invoices for accounting and expense tracking
• Subscription Modifications: Upgrade, downgrade, or modify subscription terms
• Billing Address Updates: Maintain current billing information

Security Features:

• Encrypted Communication: All data transmission is encrypted
• Secure Authentication: Access requires proper email verification
• PCI Compliance: Industry-standard security for payment processing
• Session Management: Automatic logout for security

Billing Best Practices

Regular Monitoring: Periodically review your billing information and payment history

Payment Method Updates: Keep payment methods current to avoid service interruptions

Invoice Management: Download and save invoices for your business records

Contact Information: Ensure billing contact information stays current

Support and Communication

Report Bug System

Direct Communication: The Report Bug button, located at the bottom of most admin screens, provides direct communication with IronGlove Studio® support.

What You Can Report:

• Bugs and Issues: Technical problems or unexpected behavior
• Feature Requests: Suggestions for new functionality or improvements
• Usage Questions: Help with using specific features
• Performance Concerns: Issues with speed or reliability

Why Use Report Bug:

• Speed: Direct connection to IronGlove Studio® support team
• Context: Automatically includes your system information for better troubleshooting
• Tracking: Creates a record of your support interactions
• Priority: Issues reported through the system receive prompt attention

Effective Support Communication

Be Specific: Provide detailed descriptions of issues including:

• What you were trying to do
• What happened instead
• Any error messages you received
• Steps to reproduce the problem

Include Context: Mention:

• Your domain and website setup
• Recent changes or updates
• Browser and device information (if relevant)
• Screenshots of issues (when helpful)

Response Expectations:

• IronGlove Studio® monitors bug reports regularly
• Response times vary based on issue complexity and severity
• Critical issues affecting site functionality receive priority
• Feature requests are logged for future development consideration

Alternative Support Channels

Documentation: Reference this user guide and the Google API Setup Guide for common questions

System Status: Check the Dashboard for license and configuration status

Community Resources: Consider WordPress and mapping community forums for general questions

Professional Services: Contact IronGlove Studio® directly for custom development or consultation needs

Account Maintenance Best Practices

Regular Account Health Checks

Monthly Review:

• Verify subscription status remains active
• Check that domains are correctly configured
• Review billing information for accuracy
• Test map functionality across your sites

Quarterly Maintenance:

• Review usage patterns and performance
• Update organizational information if changed
• Evaluate whether current subscription tier meets your needs
• Plan for any upcoming domain or hosting changes

Preparing for Renewal

Advance Planning: Begin renewal planning 30-60 days before expiration

Budget Approval: Secure budget approval for subscription renewal

Payment Method Verification: Ensure payment methods are current and valid

Feature Evaluation: Consider whether you need different features or tier levels

Troubleshooting Account Issues

Common Issues and Solutions:

Cannot Access Stripe Portal:

• Verify email address matches original purchase
• Ensure account details are saved before clicking Stripe Portal link
• Check for browser cookie or privacy settings blocking the portal

Domain Authorization Problems:

• Confirm domains are properly registered in Account settings
• Check for typos in domain names
• Verify DNS settings point to correct hosting

Subscription Status Confusion:

• Check Dashboard license indicator for current status
• Review Account section for detailed subscription information
• Contact support if status indicators conflict

Report Bug Not Working:

• Try refreshing the page and attempting again
• Check internet connection and browser functionality
• Contact support through alternative means if system issues persist

Planning for Business Growth

Scaling Your IronMaps™ Usage

Traffic Growth: Monitor how increased website traffic affects your mapping system performance

Content Expansion: Plan for growth in the number of map points and complexity Team Access: Consider who needs administrative access as your organization grows

Integration Needs: Evaluate potential integrations with other business systems

Subscription Evolution

Usage Monitoring: Track how your mapping needs evolve over time

Feature Requirements: Identify new features that would benefit your organization

Performance Needs: Monitor whether current subscription tier meets growing demands

Budget Planning: Include IronMaps™ costs in long-term technology budgeting

Conclusion

Effective account management ensures your IronMaps™ system remains reliable, secure, and properly licensed. Regular attention to subscription status, domain configuration, and billing management prevents service interruptions and maintains optimal system performance.

The Account section provides all the tools needed for comprehensive subscription management, from basic status monitoring to detailed billing control through the secure Stripe Portal. Combined with direct support communication through the Report Bug system, you have everything needed to maintain a professional, well-supported mapping solution.

Key Takeaways:

• Monitor subscription status regularly to avoid service interruptions
• Keep domain registrations current and properly configured
• Use the Stripe Portal for secure, comprehensive billing management
• Leverage the Report Bug system for efficient support communication
• Plan ahead for renewals and business growth

Account management is an ongoing responsibility that ensures your IronMaps™ investment continues to deliver value for your organization. Regular attention to these administrative details maintains system reliability and supports business continuity.

Overview

Once you've configured your IronMaps™ settings and added your business locations, displaying your interactive map on your WordPress website is straightforward. The map is embedded using a simple shortcode that you can add to any WordPress page or post.

This guide covers the basic process of adding your map to a page, understanding the one-map-per-page limitation, and exploring options for displaying multiple filtered views of your data across different pages.

Important Note: IronMaps™ is designed to display one map per page. Multiple maps on the same page will conflict due to how the plugin creates its container elements. For different filtered views of your data, create separate pages with different shortcode configurations.

Adding the Basic Map

The Simple Shortcode

To display your map with all business locations and default settings, add this shortcode to any WordPress page or post:

[igs_map]

This displays an interactive map showing all your published business locations with the default width (100%), height (70vh), and zoom level (10).

Using the Shortcode Generator

For a more visual approach to creating your shortcode, IronMaps™ includes a built-in shortcode generator:

1. Navigate to the Map Points tab in your admin interface
2. Click the Generate Shortcode button
3. Select the parameters you want to use (filtering options, dimensions, zoom level, etc.)
4. The tool will automatically generate the complete shortcode with your selected options
5. Copy the generated shortcode and paste it into your WordPress page

Benefits:

• No need to remember parameter names or syntax
• Visual selection of filtering options
• Automatically formatted shortcode output
• Reduces errors from manual typing

This is especially helpful when creating complex filtered maps with multiple taxonomy parameters.

Where to Add the Shortcode

WordPress Pages:

1. Navigate to Pages → Add New or edit an existing page
2. Add a new block (use the + button or type /shortcode)
3. Select the Shortcode block type
4. Paste [igs_map] into the shortcode block
5. Publish or Update the page

WordPress Posts:

• Follow the same process for posts if you want your map to appear within blog content
• Less common but fully supported

Tip: Most users create a dedicated page (e.g., "Business Directory" or "Find a Location") specifically for their map rather than embedding it in blog posts.

Understanding the One-Map Limitation

Why Only One Map Per Page?

IronMaps™ creates a container with a fixed ID (igs-map-container-wp) when rendering the map. Because HTML IDs must be unique on a page, adding multiple shortcodes on the same page causes conflicts:

• Both maps will show the same filtered results (typically the last shortcode's settings)
• JavaScript initialization conflicts may occur
• Map controls and interactions may not work as expected

The Solution: Multiple Pages

Instead of placing multiple maps on one page, create separate pages for different map views:

Example Structure:

• Page 1 (/restaurants/): [igs_map filtered="true" categories="eat"]
• Page 2 (/shopping/): [igs_map filtered="true" categories="shop"]
• Page 3 (/services/): [igs_map filtered="true" categories="services"]

This approach provides:

• Clean, focused pages for each category or filter
• Better user experience with dedicated URLs
• Proper functionality for each map instance
• Improved SEO with targeted page content

Customizing Your Map Display

Adjusting Dimensions and Zoom

You can customize the map's size and initial zoom level:

[igs_map width="90%" height="500px" zoom="12"]

Common Customizations:

• width: Any CSS value (100%, 800px, 90vw)
• height: Any CSS value (500px, 60vh, 600px)
• zoom: Number between 1 (world view) and 20 (street level)

Setting a Custom Center Point

Override automatic centering to focus on a specific location:

[igs_map center_lat="40.7128" center_lng="-74.0060" zoom="15"]

This centers the map on specific coordinates (New York City in this example) at a closer zoom level.

Filtered Map Displays

Enabling Filtering

To display only specific business locations based on categories, tags, or other taxonomies, you must set filtered="true":

[igs_map filtered="true" categories="eat, play"]

Important: The filtered="true" parameter is required for any taxonomy filtering to work.

Common Filtering Examples

Filter by Categories:

[igs_map filtered="true" categories="eat, play"]

Shows only businesses in the "eat" and "play" categories.

Filter by Special Terms/Tags:

[igs_map filtered="true" filters="veteran-owned, women-owned"]

Shows only businesses tagged as "veteran-owned" or "women-owned".

Filter by Location/Center Points:

[igs_map filtered="true" center-points="downtown, uptown"]

Shows only businesses in the "downtown" and "uptown" areas.

Filter by Industry:

[igs_map filtered="true" industries="healthcare-medical, technology-telecommunications"]

Shows only businesses in healthcare and technology industries.

Filter by Community Classifications:

[igs_map filtered="true" communities="lgbtqia+, minority-owned"]

Shows only businesses with LGBTQIA+ or minority-owned classifications.

Filter by COBID Certifications:

[igs_map filtered="true" cobid="mbe, wbe"]

Shows only businesses with MBE or WBE certifications.

Complex Multi-Taxonomy Filtering

You can combine multiple filters to create highly targeted map displays:

[igs_map filtered="true" categories="eat" industries="food-dining" communities="women-owned"]

This shows only food/dining businesses in the "eat" category that are women-owned.

Note: Multiple taxonomy filters work with AND logic, meaning businesses must match ALL specified criteria to appear on the map.

Creating Multiple Filtered Pages

Planning Your Page Structure

When you need to display different filtered views of your data, plan a logical page structure:

Directory by Category:

• /directory/restaurants/ - Food and dining establishments
• /directory/retail/ - Shopping locations
• /directory/services/ - Service providers

Directory by Certification:

• /certified/minority-owned/ - MBE certified businesses
• /certified/women-owned/ - WBE certified businesses
• /certified/veteran-owned/ - Veteran-owned businesses

Directory by Location:

• /locations/downtown/ - Downtown businesses
• /locations/north-side/ - North side businesses
• /locations/south-side/ - South side businesses

Implementation Example

Create a dedicated page for each filtered view:

Restaurant Page (/restaurants/):

[igs_map filtered="true" categories="eat"]

Shopping Page (/shopping/):

[igs_map filtered="true" categories="shop"]

Women-Owned Directory (/women-owned/):

[igs_map filtered="true" communities="women-owned"]

Each page can include additional content above or below the map explaining the filter, providing context, or offering additional resources.

Best Practices

Page Content Organization

Above the Map:

• Brief introduction explaining what the map shows
• Any filtering criteria being applied
• Instructions for using the map (optional)

Below the Map:

• Additional information about the businesses shown
• Links to related filtered pages
• Contact information or submission forms

Performance Considerations

• Keep Filters Reasonable: Avoid overly complex multi-taxonomy filters that might slow loading
• Use Caching: WordPress page caching helps improve map load times
• Optimize Business Data: Ensure business listings are complete but not excessively large

User Experience Tips

• Clear Navigation: If using multiple filtered pages, provide clear navigation between them
• Descriptive Titles: Use page titles that clearly indicate what's being shown ("Veteran-Owned Businesses" vs. "Directory")
• Consistent Layout: Maintain similar page layouts across all your directory pages

Testing Your Map Display

After adding the shortcode to a page:

1. Preview the page before publishing to ensure the map loads correctly
2. Test all interactive elements: Verify clicking on business markers opens info windows
3. Check mobile display: Ensure the map is responsive on mobile devices
4. Verify filtering: If using filtered views, confirm only the correct businesses appear
5. Test on different browsers: Check Chrome, Firefox, Safari for compatibility

Troubleshooting

Map Not Displaying

Check the following:

• Is the Google API key configured correctly in Settings?
• Are there published business locations in your database?
• Is the shortcode spelled correctly with square brackets?
• Check browser console for JavaScript errors

Wrong Businesses Appearing

Verify filtering settings:

• Is filtered="true" set when using taxonomy filters?
• Are taxonomy term slugs spelled correctly (not display names)?
• Do the businesses have the correct taxonomy terms assigned?
• Check for extra spaces in comma-separated values

Multiple Maps on Same Page

Solution: Remove all but one map shortcode and create separate pages for each filtered view. Multiple maps on the same page are not supported.

Next Steps

Now that your map is displaying on your website, you may want to:

• Customize appearance: Adjust colors, marker styles, and other visual elements
• Add more filtering options: Create additional filtered pages for different audience segments
• Monitor analytics: Track how users interact with your map
• Update business data: Keep your listings current with regular updates

We are currently aware of the following minor issues that will be addressed in upcoming patches:

• If there are a lot of center points in the Visual Metrics output, they can get crowded. We're working on logic to split these after an acceptable number of items so that the report can be more easily read under these extreme conditions.
• More than 400 points can lead to progressive slowdown, which is a pretty common issue with Google Maps; however, we are working on some modified logic that also involves caching to make this much easier to handle, even on mobile devices. So far we've experimented with up to 600 points successfully, but we need to do more testing.
• Some users may experience duplicate or 'ghost' pins appearing intermittently on maps. We're aware of this issue and working on a fix. Rest assured, all your map data is safe and the functionality still works. UPDATE: As of 10-9-25 we believe this may be fixed, waiting for additional user feedback.
• Metrics charts and statistics may not update automatically after making changes to categories or taxonomies. If you don't see your changes reflected immediately, simply refresh your browser page to view the updated data. This will be patched in an upcoming release.

Please remember that we have a button in your admin panel that generates a small feedback form. Please put any bugs you find in this form, along with any suggestions you may also have for future features, and that goes directly to our project management platform and we'll see that within minutes. Thank you!

We have a lot in store for this product over the next year. While we can't comprehensively release a full roadmap due to strategic reasons, we will be addressing the following items:

• Adding an additional view for membership-based and nonprofit organizations to insert either a traditional "member directory" that outputs full on-page SEO and proper schema, or (if more applicable) a modified version of that to have a searchable index of community resources and related points. This was a promised feature to those groups of customers that we're going to make good on very shortly, we didn't want to delay launch because of it as they can get started with the interactive mapping now versus later. That data will be structured on the front-end for these modified views.
• Further study and improvements to the user interface to make the workflow faster and more efficient, we'll have Paul work his magic.
• Additional optimizations to the logic and methods used to inject and render data points so that more points can be handled without browsers bogging down (a common issue with many platforms, mostly due to API and rendering restrictions).
• Adding another alternative mapping engine so that users aren't cornered to use just the Google ecosystem, with more to come after that (each system is different, it takes time to research and integrate, but Google maps are widely used so we went with that for the initial release).
• Development is underway to transform the current fixed metrics display into a fully configurable analytics system. This enhancement will include customizable chart options, advanced filtering capabilities, and comprehensive reporting features. Users will be able to export detailed data analysis in multiple formats including Excel spreadsheets, CSV files, and formatted PDF reports, providing flexible options for sharing insights with stakeholders and maintaining records for business analysis.
• We'll be adding finished logic for internal tracking (e.g., click events and related) along with methods to help with external tracking (i.e., Matomo/Piwik, Google Analytics, Bing Webmaster Console, etc.) so that you have a better idea of what's going on with user interactions. This was a request from several Chambers of Commerce and we're making that another priority.

Initial release of IronMaps™ featuring complete map point management, hierarchical organization system with categories and tags, Google Maps API integration, real-time admin interface, and comprehensive account management with Stripe billing integration. Includes specialized filters for industries, communities, and COBID certifications along with customizable display settings and direct support communication tools.