Beskrivelse
Mandat AEO Assistant is a powerful WordPress plugin that leverages Google’s Gemini AI and Vertex AI to automatically generate high-quality, SEO-optimized blog posts. The plugin provides a comprehensive Article Studio interface where you can:
- Generate long-form articles (>=1600 words) using Google Gemini 2.0/2.5 models
- Create AI-generated featured and in-content images using Imagen 4.0
- Automatically insert internal links from your existing content
- Find and embed relevant YouTube videos
- Generate SEO metadata (meta descriptions, focus keywords, tags)
- Support for both Vietnamese and English content
- Automatic translation with Polylang integration
- Real-time cost tracking for all API usage
The plugin is designed for content creators, bloggers, and digital marketers who want to streamline their content production workflow while maintaining high quality and SEO best practices.
External Services
This plugin connects to external Google Cloud services to provide AI-powered features. Below is detailed information about each service used, what data is transmitted, and when these connections occur.
Google Cloud Vertex AI – Gemini API
Purpose: Generates AI-powered article content using Google’s Gemini language models (gemini-2.0-flash-exp, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite).
When used:
– When you click “Create Article” in the Article Studio interface
– When using the automatic translation feature with Polylang
Data sent to Google:
– Your article topic, keywords, and content generation parameters
– Source text for translation (when translating existing content)
– Your Google Cloud Service Account credentials for authentication
– No personal user data from your website visitors is ever sent
Data received from Google:
– Generated HTML article content
– SEO metadata suggestions (titles, descriptions, keywords)
– Token usage statistics for cost tracking
API Endpoint: https://us-central1-aiplatform.googleapis.com/v1/projects/{project_id}/locations/us-central1/publishers/google/models/
Service Terms: https://cloud.google.com/terms
Privacy Policy: https://policies.google.com/privacy
Google Cloud Vertex AI – Imagen API
Purpose: Generates AI images for featured images and in-content illustrations using Google’s Imagen 4.0 model.
When used:
– When you click “Generate Images” after article creation
– Images are only generated when you explicitly request them
Data sent to Google:
– Text prompts describing the desired images
– Image generation parameters (aspect ratio, style)
– Your Google Cloud Service Account credentials
– No personal data or user information is transmitted
Data received from Google:
– Base64-encoded PNG image data
– Generation metadata
API Endpoint: https://us-central1-aiplatform.googleapis.com/v1/projects/{project_id}/locations/us-central1/publishers/google/models/imagen-4.0-generate-001:predict
Service Terms: https://cloud.google.com/terms
Privacy Policy: https://policies.google.com/privacy
Google OAuth2 API
Purpose: Authenticates your Google Cloud Service Account to securely access Vertex AI services.
When used: Automatically before each API call to Gemini or Imagen (access tokens are cached for 55 minutes to minimize requests).
Data sent to Google:
– JWT (JSON Web Token) signed with your Service Account private key
– Service Account email address
– Timestamp and token expiration data
Data received from Google:
– Temporary access token (valid for 1 hour)
– Token expiration timestamp
API Endpoint: https://oauth2.googleapis.com/token
Service Terms: https://developers.google.com/terms
Privacy Policy: https://policies.google.com/privacy
YouTube Data API v3
Purpose: Searches for and retrieves YouTube video information to embed relevant videos in articles.
When used: Only when the “Generate YouTube Video” option is enabled during article creation.
Data sent to Google:
– Search keywords related to your article topic
– Language and region preferences
– Your YouTube Data API key
Data received from Google:
– Video IDs, titles, and descriptions
– Channel information
– Video metadata (upload date, thumbnails)
API Endpoint: https://www.googleapis.com/youtube/v3/search
Service Terms: https://developers.google.com/youtube/terms/api-services-terms-of-service
Privacy Policy: https://policies.google.com/privacy
Google Custom Search API
Purpose: Searches the web to gather factual information and current sources to enhance article accuracy and relevance.
When used: Automatically during article generation to provide the AI with up-to-date context and credible sources.
Data sent to Google:
– Search queries based on your article topic and keywords
– Language and region preferences
– Your Custom Search Engine ID and API key
– Number of results requested (typically 3-10)
Data received from Google:
– Search result titles, URLs, and snippets
– Page metadata
API Endpoint: https://www.googleapis.com/customsearch/v1
Service Terms: https://developers.google.com/custom-search/v1/overview
Privacy Policy: https://policies.google.com/privacy
Privacy and Data Protection
Important notes:
– No personal data from your website visitors (names, emails, IP addresses) is ever transmitted to external services
– All API calls are initiated only by authenticated WordPress administrators
– API keys and credentials are stored securely in your WordPress database (encrypted or hashed where possible)
– Generated content is saved to your WordPress database only; Google does not retain your content beyond the time needed for API processing
– Cost tracking data (token usage) is stored locally in your WordPress database
– This plugin does not use cookies or collect any user data from your site visitors
GDPR Compliance: This plugin does not collect, store, or transmit any personal data from your website visitors. All external API calls are initiated exclusively by authenticated WordPress administrators for content generation purposes.
Credits
This plugin integrates with the following Google Cloud services:
– Google Cloud Vertex AI (Gemini language models and Imagen image generation)
– Google OAuth2 API for secure authentication
– YouTube Data API v3 for video content
– Google Custom Search API for web research
All trademarks and service marks are the property of their respective owners.
Support
For support, feature requests, or bug reports, please visit: https://eonsr.com/
License
This plugin is licensed under GPL-2.0-or-later. See https://www.gnu.org/licenses/gpl-2.0.html for details.
Installation
- Upload the plugin files to
/wp-content/plugins/mandat-aeo-assistantdirectory, or install through the WordPress plugins screen. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Go to Settings > Mandat AEO Assistant to configure your Google Cloud API credentials:
- Google Cloud Service Account JSON (for Vertex AI access)
- Google Cloud Project ID
- YouTube Data API Key (optional – for video embedding)
- Custom Search API Key and Engine ID (optional – for web research)
- Navigate to Mandat AEO Assistant > Article Studio to start generating content.
FAQ
-
Do I need a Google Cloud account?
-
Yes, you need a Google Cloud account with billing enabled. The plugin uses Vertex AI (Gemini and Imagen) which are paid services. Google offers $300 in free credits for new users.
-
How much does it cost to generate an article?
-
Approximate costs per article (may vary based on configuration):
– Gemini API: $0.01 – $0.05 per article (depends on length and model)
– Imagen API: ~$0.08 for 2 images
– Custom Search API: ~$0.01 per search query
– YouTube API: Free (uses daily quota units)The plugin includes a built-in Cost Report dashboard to track all API expenses.
-
Can I use this without Polylang?
-
Yes! Polylang integration is completely optional. The plugin will work perfectly fine without Polylang installed, generating articles in your chosen language (English or Vietnamese).
-
Is the generated content unique?
-
Yes, all content is uniquely generated by Google’s Gemini AI based on your specific prompts and web research. However, you should always review and edit AI-generated content before publishing to ensure accuracy and match your brand voice.
-
What WordPress version do I need?
-
WordPress 6.0 or higher is required. The plugin has been tested up to WordPress 6.8.
-
Is my API key secure?
-
Your API keys and Service Account credentials are stored in your WordPress database. We recommend using proper file permissions and security plugins to protect your WordPress installation.
Anmeldelser
Der er ingen anmeldelser for denne widget.
Bidragsydere & udviklere
“Mandat AEO Assistant” er open source-software. Følgende personer har bidraget til dette plugin.
BidragsydereOversæt “Mandat AEO Assistant” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
3.2.8
- Updated: Comprehensive external services documentation in readme
- Fixed: Proper escaping for wp_add_inline_style() to comply with WordPress.org security guidelines
- Fixed: Removed direct style block creation in AJAX handlers
- Improved: Code security and WordPress coding standards compliance
- Enhanced: Privacy and GDPR compliance documentation
3.2.7
- Fixed: Proper use of wp_add_inline_style() instead of echoing style tags
- Fixed: Removed direct style block creation in AJAX handlers
- Improved: Updated code to comply with WordPress.org plugin guidelines
- Updated: Comprehensive documentation of external services in readme
3.2.5
- Added: Polylang automatic translation support
- Added: Internal link translation for multilingual sites
- Improved: Cost tracking for translation operations
- Fixed: Image generation error handling
3.2.4
- Added: Real-time content editing in preview
- Added: Category selection for posts
- Improved: UI/UX with better loading states
- Fixed: CSS scoping issues
3.2.3
- Added: Cost report filtering by date range
- Added: Detailed token usage breakdown
- Improved: Database structure for better performance
3.2.0
- Initial public release
- Gemini 2.0 and 2.5 model support
- Imagen 4.0 image generation
- YouTube video embedding
- Custom Search integration
