Title: Mapfolia – Project Portfolio Map &amp; Local SEO
Author: highbridge
Published: <strong>2026 年 8 月 28 日</strong>
Last modified: 2026 年 8 月 28 日

---

搜尋外掛

![](https://s.w.org/plugins/geopattern-icon/mapfolia.svg)

# Mapfolia – Project Portfolio Map & Local SEO

 由 [highbridge](https://profiles.wordpress.org/highbridge/) 開發

[下載](https://downloads.wordpress.org/plugin/mapfolia.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/mapfolia/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/mapfolia/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/mapfolia/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/mapfolia/#developers)

 [技術支援](https://wordpress.org/support/plugin/mapfolia/)

## 外掛說明

Mapfolia is a portfolio plugin built for businesses whose work happens at a location:
contractors, remodelers, builders, landscapers, roofers, pool builders, architects,
and similar trades.

Every project gets a location, a photo gallery, key details, and optional client
review — and the plugin turns that into the structured data, meta tags, and keyword-
rich image alt text that help local search engines understand what you do and where
you do it.

**Frontend**

 * Filterable project grid with staggered animations and a details lightbox
 * Interactive map of all project locations with marker clustering (no API key needed)
 * Full-page single project template: hero gallery, details sidebar, location map,
   previous/next navigation
 * Dark, premium look out of the box; every color and font is a CSS variable you
   can override
 * Works with classic and block (full site editing) themes
 * Fully responsive, keyboard accessible

**Project management**

 * Custom post type with Project Type and Location taxonomies
 * Gallery uploader with drag-to-reorder
 * Value range, square footage, dates, status (Planning / In Progress / Completed/
   Featured)
 * Key features, case study, and an optional real client review
 * Click-to-set map location picker

**Local SEO**

 * Service, CreativeWork, ImageObject, FAQ, Breadcrumb and ItemList structured data
   per project
 * Optional LocalBusiness structured data with service areas and social profile 
   links
 * Geo meta tags, Open Graph tags, and auto-generated keyword-rich alt text for 
   photos
 * Settings to avoid duplicate output when you also run Yoast, Rank Math, AIOSEO,
   SEOPress, or The SEO Framework

**Optional AI drafting**

The plugin can draft a project’s description, features, case study, and SEO fields
from a photo. On WordPress 7.0+ it uses the core AI Client, so a provider configured
once under Settings  Connectors powers the feature with no extra setup. On older
WordPress versions (or as a fallback), add your own Anthropic (Claude) or OpenAI(
ChatGPT) API key in the plugin’s settings. Nothing is sent unless you click the 
button.

#### Shortcodes

 * `[lpsc_showcase]` — full showcase: header, filters, grid, map, lightbox
 * `[lpsc_map height="550px" zoom="10"]` — map only
 * `[lpsc_grid limit="6" columns="3" type="kitchen-remodel"]` — simple grid

All three accept `type`, `location`, and `status` filters. The showcase also accepts`
title`, `subtitle`, `eyebrow`, `show_header`, `show_filters`, and `show_map`.

### Third-party services

This plugin uses the following external services:

**OpenStreetMap tiles** — maps are drawn with tiles from tile.openstreetmap.org.
Visitors’ browsers request these tiles directly when a map is displayed. See the
[OpenStreetMap tile usage policy](https://operations.osmfoundation.org/policies/tiles/)
and [privacy policy](https://wiki.osmfoundation.org/wiki/Privacy_Policy). High-traffic
sites should consider a commercial tile provider (the tile URL is filterable).

**Google Fonts** (optional, on by default) — DM Serif Display and Plus Jakarta Sans
are loaded from fonts.googleapis.com. Disable this in Settings  Display if you prefer
to self-host fonts or must avoid third-party requests. See the [Google Fonts privacy FAQ](https://developers.google.com/fonts/faq/privacy).

**AI providers** (optional, off by default) — clicking “Generate” on a project sends
that project’s cover photo, title, and any context you type to an AI provider to
draft content. On WordPress 7.0+ with a provider configured under Settings  Connectors,
the request goes through the WordPress core AI Client to the provider the site owner
chose there. Otherwise, the plugin calls Anthropic or OpenAI directly using the 
API key from its settings; that key is stored in your WordPress database. See [Anthropic’s privacy policy](https://www.anthropic.com/legal/privacy)
and [OpenAI’s privacy policy](https://openai.com/policies/privacy-policy). API usage
is billed by the provider.

The bundled Leaflet (BSD-2-Clause) and Leaflet.markercluster (MIT) libraries are
served from your own site.

## 安裝方式

 1. Upload the `mapfolia` folder to `/wp-content/plugins/`, or install the zip via 
    Plugins  Add New.
 2. Activate the plugin.
 3. Go to **Projects  Settings** and enter your business information.
 4. Add Project Types (e.g. Kitchen Remodel, New Construction) under **Projects  Project
    Types**.
 5. Add projects with a cover image, gallery photos, and a map location.
 6. Place `[lpsc_showcase]` on a page, or send visitors to `/projects/`.

## 常見問題集

### Does the map need a Google Maps API key?

No. Maps use Leaflet with OpenStreetMap tiles, which are free for normal website
use.

### Can I change the colors and fonts?

Yes. Add overrides to your theme’s stylesheet or the Customizer’s Additional CSS:

    ```
    :root {
      --lpsc-primary: #1a2332;      /* page background */
      --lpsc-accent: #c8956c;       /* accent color */
      --lpsc-accent-light: #e0b892;
      --lpsc-surface: #1e2a3a;      /* card background */
      --lpsc-text: #e8eaed;
      --lpsc-font-display: Georgia, serif;
      --lpsc-font-body: system-ui, sans-serif;
    }
    ```

### Can I customize the templates?

Copy any file from the plugin’s `templates/` folder into `your-theme/mapfolia/` 
and edit it there. Your copy is used instead of the plugin’s and survives plugin
updates. You can also uncheck “Use built-in templates” in Settings to let your theme
render project pages entirely.

### I already use Yoast / Rank Math. Will this conflict?

On activation the plugin detects common SEO plugins and turns off its own meta tag
output so you don’t get duplicate description and Open Graph tags. Project structured
data is still output because SEO plugins don’t generate it. Leave “LocalBusiness
structured data” off if your SEO plugin already outputs an Organization or LocalBusiness
block.

### The /projects/ page shows a 404

Go to Settings  Permalinks and click Save (no changes needed). This refreshes WordPress’s
rewrite rules.

### Is the AI feature required?

No. It is entirely optional and does nothing until an AI backend is available (a
provider under Settings  Connectors on WordPress 7.0+, or an API key in the plugin’s
settings). The plugin never sends data anywhere on its own.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Mapfolia – Project Portfolio Map & Local SEO〉的開發相關
工作。

參與者

 *   [ highbridge ](https://profiles.wordpress.org/highbridge/)

[將〈Mapfolia – Project Portfolio Map & Local SEO〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/mapfolia)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/mapfolia/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/mapfolia/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/mapfolia/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/mapfolia/)。

## 變更記錄

#### 1.0.0

 * Initial public release.

## 中繼資料

 *  版本 **1.0.0**
 *  最後更新 **3 週前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.9 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.1.1**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/mapfolia/)
 * 標籤:
 * [contractor](https://tw.wordpress.org/plugins/tags/contractor/)[local seo](https://tw.wordpress.org/plugins/tags/local-seo/)
   [map](https://tw.wordpress.org/plugins/tags/map/)[portfolio](https://tw.wordpress.org/plugins/tags/portfolio/)
   [projects](https://tw.wordpress.org/plugins/tags/projects/)
 *  [進階檢視](https://tw.wordpress.org/plugins/mapfolia/advanced/)

## 評分

這個項目尚無任何評論記錄。

[撰寫評分](https://wordpress.org/support/plugin/mapfolia/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/mapfolia/reviews/)

## 參與者

 *   [ highbridge ](https://profiles.wordpress.org/highbridge/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/mapfolia/)