initial commit

native/wordpress/maple-fonts-wp/readme.txt

@@ -0,0 +1,155 @@
+=== Maple Local Fonts ===
+Contributors: mapleopentech
+Tags: fonts, google fonts, local fonts, gdpr, typography, privacy
+Requires at least: 6.5
+Tested up to: 6.7
+Requires PHP: 7.4
+Stable tag: 1.0.0
+License: GPL-2.0-or-later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+Import Google Fonts to local storage for GDPR-compliant, privacy-friendly typography. Fonts are served from your server, not Google.
+
+== Description ==
+
+**Maple Local Fonts** allows you to import Google Fonts to your WordPress site's local storage. Once imported, fonts are served directly from your server — Google is never contacted again.
+
+= Why Local Fonts? =
+
+* **GDPR Compliance**: Serving fonts from Google's servers can transfer visitor IP addresses to Google, which may violate GDPR. Local fonts eliminate this concern.
+* **Performance**: Local fonts can load faster since they're served from your own server without additional DNS lookups.
+* **Privacy**: Your visitors' data stays private — no third-party requests for fonts.
+* **Reliability**: Fonts are always available, even if Google's services are blocked or unavailable.
+
+= Features =
+
+* **Simple Import**: Enter a font name, select weights and styles, and click to import.
+* **WordPress Integration**: Fonts automatically appear in the Full Site Editor typography settings.
+* **Clean Removal**: Uninstalling the plugin removes all imported fonts and files.
+* **No Frontend Impact**: Zero JavaScript or CSS added to your frontend — only font files are served.
+
+= How It Works =
+
+1. Enter the Google Fonts name (e.g., "Open Sans")
+2. Select the weights (400, 700, etc.) and styles (normal, italic)
+3. Click "Download & Install"
+4. The plugin downloads the font files and registers them with WordPress
+5. Use the fonts in Appearance → Editor → Styles → Typography
+
+= Requirements =
+
+* WordPress 6.5 or higher (required for Font Library API)
+* PHP 7.4 or higher
+
+== Installation ==
+
+1. Upload the `maple-local-fonts` folder to `/wp-content/plugins/`
+2. Activate the plugin through the Plugins menu
+3. Go to Appearance → Local Fonts
+4. Import your desired fonts
+
+== Frequently Asked Questions ==
+
+= Does this plugin contact Google after importing a font? =
+
+No. The plugin only contacts Google Fonts once, during the import process. After that, fonts are served entirely from your server.
+
+= Where are the font files stored? =
+
+Font files are stored in `wp-content/fonts/`, which is WordPress's default font directory.
+
+= Can I use these fonts with any theme? =
+
+**Block Themes (FSE):** Imported fonts automatically appear in Appearance → Editor → Styles → Typography.
+
+**Classic Themes:** Fonts are registered but must be applied via custom CSS. After importing, add CSS like this to your theme or Customizer:
+
+`body { font-family: "Open Sans", sans-serif; }`
+
+The plugin will detect your theme type and show appropriate instructions.
+
+= What happens to the fonts if I uninstall the plugin? =
+
+When you delete the plugin, all imported fonts and their files are removed. This ensures a clean uninstall.
+
+= Is this plugin GDPR compliant? =
+
+Yes. After importing, fonts are served from your own server. No visitor data is sent to Google or any third party.
+
+= What font formats are downloaded? =
+
+The plugin downloads WOFF2 format, which is the most efficient and widely supported web font format.
+
+= Can I import fonts that aren't on Google Fonts? =
+
+No, this plugin only supports importing from Google Fonts. For other fonts, you would need to manually upload them.
+
+= I'm using Wordfence/a firewall and imports are failing =
+
+If font imports fail, your firewall may be blocking outbound requests. Whitelist these domains:
+
+* `fonts.googleapis.com` (for font CSS)
+* `fonts.gstatic.com` (for font files)
+
+**Wordfence:** Go to Wordfence → Firewall → Blocking and ensure these domains aren't blocked. If using Learning Mode, imports should work and the domains will be automatically learned.
+
+**Other firewalls:** Add the above domains to your outbound request allowlist.
+
+= The plugin says it requires WordPress 6.5 =
+
+WordPress 6.5 introduced the Font Library API that this plugin uses. Earlier versions don't support local font registration. Please update WordPress to use this plugin.
+
+== Compatibility ==
+
+= Tested With =
+
+* **WordPress:** 6.5, 6.6, 6.7
+* **WooCommerce:** 8.0+ (HPOS compatible)
+* **Wordfence:** 7.10+ (see FAQ for firewall settings)
+* **LearnDash:** 4.10+
+* **Popular Block Themes:** Twenty Twenty-Four, Twenty Twenty-Five
+
+= Theme Compatibility =
+
+* **Block Themes (FSE):** Full support via Site Editor typography settings
+* **Classic Themes:** Supported via custom CSS (instructions shown in admin)
+
+== Privacy ==
+
+= Data Collection =
+
+This plugin does not collect any personal data from your website visitors.
+
+= External Services =
+
+This plugin connects to Google Fonts (fonts.googleapis.com and fonts.gstatic.com) **only during the font import process** in the WordPress admin area. This connection is:
+
+* Initiated only by administrators
+* Used only to download font files
+* Not repeated after initial download
+
+After import, no external connections are made. Fonts are served entirely from your server.
+
+= Cookies =
+
+This plugin does not set any cookies.
+
+== Screenshots ==
+
+1. The font import interface
+2. Installed fonts list with delete option
+3. Fonts appearing in the Full Site Editor typography settings
+
+== Changelog ==
+
+= 1.0.0 =
+* Initial release
+* Import Google Fonts to local storage
+* WordPress Font Library integration
+* Admin interface for font management
+* Clean uninstall functionality
+
+== Upgrade Notice ==
+
+= 1.0.0 =
+Initial release of Maple Local Fonts.