Manhattin Website Integration

What's Included

This folder contains everything needed to integrate Manhattin with client websites:

1. WordPress Plugin (manhattin-integration.zip)

Ready-to-install WordPress plugin with shortcodes for unit listings and contact forms

2. Documentation

• README.md (this file) - Overview and quick fixes
• WORDPRESS_GUIDE.md - Contact form setup and integrations

• API_REFERENCE.md - Complete API reference with examples
• QUICK_START.md - Fast 5-minute integration guide
• CLIENT_OPTIONS.md - Comparison of plugin vs API integration
• TESTING.md - Testing procedures and checklist
• ORG_API_GUIDE.md - Multi-property organization API

Latest Updates

• Plugin was looking for available_units but API returns units
• Changed $unit['market_rent'] → $unit['rent']
• Fixed single unit endpoint to use correct response structure
• Added budget range to inquiry submissions

Installation

1. Download the manhattin-integration.zip file
2. Upload to WordPress:

- Click "Upload Plugin"

- Choose manhattin-integration.zip

- Click "Install Now"

1. Activate the plugin
2. Configure:

- Enter your API URL: https://manhattin.com

- Enter your API Key: pk_live_0123456789abcdef... (your full API key)

- Save settings

Usage

Display All Available Units

Add this shortcode to any page:

[manhattin_availability]

With Filters

[manhattin_availability bedrooms="2" max_rent="2500"]

Hide Filters

[manhattin_availability show_filters="no"]

Display Single Unit

[manhattin_unit id="unit-id-here"]

What It Does

The plugin will:

• Fetch all available units from your Manhattin API
• Display them in a responsive grid
• Show bedrooms, bathrooms, square feet, and rent
• Include features if available
• Cache results for 1 hour (configurable)
• Provide filters for bedrooms and max rent
• Show "Schedule Tour" and "View Details" buttons

Updating Existing Installation

If you already have the plugin installed and configured:

1. Deactivate the old plugin (Settings will be preserved)
2. Delete the old plugin files
3. Upload and install the new manhattin-integration.zip
4. Activate the new version
5. Clear cache: Delete transient cache from WordPress Admin → Tools → Site Health → Clear Caches (if you have a cache plugin)

OR manually clear Manhattin cache:

delete_transient('manhattin_units_' . md5('{}'));

API Endpoints Used

• GET /api/public/availability - Fetch all available units
• GET /api/public/unit/{id} - Fetch single unit details
• POST /api/public/inquiries - Submit contact form (if contact form feature is used)

Testing

After installation:

1. Add shortcode to a test page: [manhattin_availability]
2. View the page on your site
3. Check browser console (F12) for any errors
4. You should see all available units displayed

Troubleshooting

No units showing?

1. Check Settings → Manhattin Settings - API key and URL are correct
2. Enable WordPress Debug: Add to wp-config.php:

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);

1. Check wp-content/debug.log for API errors
2. Verify API is accessible: Test in browser: https://manhattin.com/api/public/availability

"Unable to load availability" error?

• API key not configured
• API URL incorrect
• API endpoint not accessible
• CORS issues (check allowed_origins in Manhattin admin)

Wrong data showing?

• Clear WordPress cache
• Clear browser cache
• Check API response in browser Network tab

Two Integration Options

Option 1: WordPress Plugin (Easiest)

• Install manhattin-integration.zip
• Add shortcodes: [manhattin_availability] and [manhattin_contact_form]
• No coding required
• See: WORDPRESS_GUIDE.md

Option 2: Direct API Integration (Full Control)

• Use your own design and forms
• Call our REST API endpoints directly
• Works with any platform (not just WordPress)
• See: API_REFERENCE.md or QUICK_START.md

Documentation Index

Support

• Check wp-content/debug.log
• Verify Settings → Manhattin Settings are correct
• Clear WordPress cache
• Check shortcode syntax

• See API_REFERENCE.md for complete documentation
• Test with cURL first
• Check CORS configuration
• Verify API key is active

• Plugin: Check wp-content/debug.log
• API: Verify API key and URL match your Manhattin instance
• Email: developer@manhattin.com for further assistance