Installation and Upgrade

Requirements

• WordPress 7.0 is the current live target.
• PHP 8.3 is the current live runtime target.
• The plugin metadata keeps Requires PHP: 7.4 for backward compatibility unless project requirements change.
• WPML is optional, but required for Spanish translation workflows.

Install From Release ZIP

1. Download the latest ZIP from the Forgejo Releases page.
2. In WordPress Admin, go to Plugins > Add New > Upload Plugin.
3. Upload oregon-farmers-market-locator-vX.Y.Z.zip.
4. Activate Oregon Farmers Market Locator.
5. Go to Farmers Markets > Settings and review map, filter, geocoding, and marker settings.

Upgrade

1. Back up the WordPress database and files.
2. Upload the newer release ZIP through Plugins > Add New > Upload Plugin.
3. Choose Replace current with uploaded.
4. Confirm Farmers Markets admin pages load.
5. Confirm an English map page and the Spanish map page render.
6. Confirm the shortcode builder still generates expected shortcodes.

After Upgrade Smoke Test

• Farmers Markets > Settings loads.
• Farmers Markets > CSV Import loads.
• Farmers Markets > Shortcode Builder loads.
• Farmers Markets > WPML Tools loads when WPML is active.
• [oregon_farmers_market_locator] renders.
• [oregon_farmers_market_locator lang="es"] renders Spanish data when Spanish translations exist.
• Map tiles, filters, popups, region buttons, and marker colors work.