WP Manifestindependent plugin directory
manifest / ai / brandisointi

BrändiSointi

A WordPress plugin that helps content creators, marketers, and businesses maintain consistent brand voice across all their content using AI-powered content generation.

by Jenniina Laine · github.com/jenniina/brandisointi · website

0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/jenniina/brandisointi/archive/refs/heads/main.zip

Choose your brand voice and generate content that matches your brand perfectly using AI.

BrändiSointi is a WordPress plugin that helps content creators, marketers, and businesses maintain consistent brand voice across all their content using AI-powered content generation.

Tags: ai, content generation, brand voice, openai, gutenberg, content creation, copywriting, marketing

Key Features

  • Brand Voice Templates: Pre-built templates for different communication styles
  • Custom Templates: Create detailed brand voice guidelines
  • Gutenberg Integration: Content appears as editable blocks
  • Multilingual: Finnish and English interface
  • Smart Fallbacks: Works with any WordPress editor setup
  • Security First: Proper nonces, sanitization, and capability checks

Installation

Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • OpenAI API key (Get one here)

Quick Install

  1. Download or clone this repository
  2. Upload to /wp-content/plugins/brandisointi/
  3. Activate through WordPress admin
  4. Go to Settings > BrändiSointi
  5. Add your OpenAI API key
  6. Start creating content!

How to Use

  1. Configure API: Add your OpenAI credentials in plugin settings
  2. Choose Template: Select a predefined brand voice or create custom
  3. Fill Fields: Add title, topic, key points, and source data
  4. Generate: Click generate and get AI-created content as Gutenberg blocks
  5. Edit & Publish: Customize the generated content as needed

Brand Voice Templates

  • Social Media Influencer - Energetic, authentic, community-focused
  • Professional Expert - Knowledgeable, trustworthy, solution-oriented
  • Web Developer - Technical yet accessible, problem-solving
  • Government/Public - Clear, accessible language following guidelines
  • B2B Expert - Professional, data-driven, conversion-focused
  • E-commerce - SEO-optimized, benefit-focused descriptions
  • Humorous Brand - Engaging, witty, memorable yet professional

Perfect For

  • Content Creators: Maintain consistent brand voice across all platforms
  • Marketing Teams: Ensure all team members create on-brand content
  • Small Businesses: Professional content without hiring copywriters
  • Agencies: Manage multiple brand voices for different clients
  • Bloggers: Streamline content creation while maintaining quality
  • E-commerce: Product descriptions that convert and rank well in search

Frequently Asked Questions

Do I need an OpenAI API key?

Yes, BrändiSointi requires an OpenAI API key to generate content. You can get one by signing up at platform.openai.com. The plugin uses GPT models to create content based on your brand voice guidelines.

How much does OpenAI API usage cost?

OpenAI charges based on the number of tokens (words/characters) processed. Typical content generation costs are very low - usually a few cents per piece of content. Check OpenAI's current pricing at platform.openai.com/pricing.

Can I create my own brand voice templates?

Absolutely! BrändiSointi includes a powerful custom template builder where you can define your brand's personality, tone, vocabulary, structure, and messaging guidelines. These templates ensure consistent content every time.

Does this work with the Classic Editor?

Yes! BrändiSointi includes fallback compatibility for the Classic Editor (TinyMCE) and even basic textarea editors. The plugin automatically detects your editor and uses the best insertion method available.

Is my content and API key secure?

Yes. BrändiSointi follows WordPress security best practices including nonce verification, input sanitization, and proper capability checks. Your API key is stored securely in WordPress options, and content is only sent to OpenAI's servers for processing.

Can I use this for multiple languages?

The plugin interface supports Finnish and English, with more languages planned. For content generation, you can specify the language in your brand voice template, and the AI will generate content in that language.

What happens if the API call fails?

BrändiSointi includes comprehensive error handling. If an API call fails, you'll receive a clear error message explaining what happened. The plugin also includes fallback content to ensure you always get some output.

Can I edit the generated content?

Yes! Generated content appears as standard Gutenberg blocks (or HTML in Classic Editor) that you can edit, rearrange, or modify just like any other content. The AI provides a starting point that you can customize as needed.

Does this work with custom post types?

Yes, BrändiSointi works with any post type that supports the standard WordPress editor, including custom post types, pages, and posts.

Is there a limit to how much content I can generate?

The only limits are those imposed by your OpenAI API plan. BrändiSointi itself has no built-in restrictions on content generation frequency or volume.

Development

File Structure

brandisointi/
├── brandisointi.php      # Main plugin file
├── templates.php         # Brand voice templates
├── languages/
│   └── languages.php     # Translation system
├── assets/
│   └── admin.js          # Admin JavaScript
├── uninstall.php         # Cleanup on uninstall
├── readme.txt            # WordPress.org readme
└── README.md             # This file

WordPress Standards

  • Proper plugin header and constants
  • Activation/deactivation hooks
  • Version checking and migrations
  • Uninstall cleanup
  • Security best practices
  • WordPress coding standards
  • Comprehensive error handling

Logging

The plugin uses WordPress standard logging via error_log() when WP_DEBUG and WP_DEBUG_LOG are enabled. Check your wp-content/debug.log file for plugin messages.

Configuration

Basic Setup

// In wp-config.php (optional - can also use settings page)
define('OPENAI_KEY', 'your-api-key-here');
define('ORGANIZATION_ID', 'your-org-id-here');
define('PROJECT_ID', 'your-project-id-here');

Enable Debug Logging

// In wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Multilingual Support

  • Finnish (suomi) - Complete interface and templates
  • English - Complete interface and templates
  • Extensible - Easy to add more languages

Language files are in languages/languages.php with comprehensive translation arrays.

Security Features

  • Nonce verification on all AJAX calls
  • Input sanitization and output escaping
  • Capability checks (edit_posts required)
  • Secure API credential storage
  • Proper error handling without data exposure

API Usage

The plugin integrates with OpenAI's API:

  • Model: Uses GPT models for content generation
  • Cost: Typically a few cents per content piece
  • Privacy: Content sent only for processing, not stored by OpenAI
  • Limits: Only limited by your OpenAI API plan

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Follow WordPress coding standards
  • Add proper DocBlocks to functions
  • Include appropriate security measures
  • Test with different WordPress/PHP versions
  • Update version numbers and changelog

Screenshots

  1. Plugin Interface - Clean, intuitive interface integrated into the WordPress editor sidebar
  2. Brand Voice Templates - Choose from predefined templates or create custom ones
  3. Custom Template Builder - Detailed form for creating your own brand voice guidelines
  4. Generated Content - AI-generated content appears as editable Gutenberg blocks
  5. Settings Page - Easy configuration of API credentials and plugin preferences
  6. Multi-language Support - Interface available in Finnish and English

Changelog

v1.0.0 (Latest)

  • MAJOR RELEASE - Complete production version
  • WordPress standard logging system (replaces custom file logging)
  • Plugin lifecycle hooks (activation, deactivation, uninstall)
  • Version checking and migration system
  • Enhanced security with proper capability checks
  • Comprehensive uninstall cleanup
  • WordPress.org repository preparation

Privacy Policy

BrändiSointi takes your privacy seriously:

Data Collection: The plugin only collects the content input you provide for AI processing and stores your preferences locally in WordPress.

Third-Party Services: Content is sent to OpenAI's API for processing. Please review OpenAI's privacy policy at openai.com/privacy.

Data Storage: Your API credentials and preferences are stored securely in your WordPress database. User-generated content templates are stored locally and never shared.

Data Retention: Plugin data is removed when you uninstall the plugin. OpenAI may retain data according to their retention policy.

License

This plugin is licensed under the GPL v2 or later.

Copyright (C) 2025 Jenniina Laine

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

Upgrade Notice

v1.0.0

Major production release with improved logging, lifecycle management, and WordPress standards compliance. Existing users will have their data automatically migrated. Custom log files are removed in favor of WordPress standard logging.

License

This plugin is licensed under the GPL v2 or later.

Copyright (C) 2025 Jenniina Laine
## Support & Credits

### Support

For support, feature requests, or bug reports:

- **Email Support**: [brandisointi@jenniina.fi](mailto:brandisointi@jenniina.fi) (fastest response for plugin-specific issues)
- **Documentation**: Visit our comprehensive guide at [brandisointi.jenniina.fi/docs](https://brandisointi.jenniina.fi/docs)
- **Support Forum**: Use the WordPress.org support forum for this plugin
- **Developer Contact**: For general inquiries, visit [jenniina.fi/contact](https://jenniina.fi/contact)
- **GitHub**: Report issues and contribute at [github.com/jenniinalaine/brandisointi](https://github.com/jenniinalaine/brandisointi)

### Credits

**Developer**: Jenniina Laine ([jenniina.fi](https://jenniina.fi))
**Powered by**: OpenAI GPT models
**Inspiration**: The need for consistent, authentic brand voice in content creation
**Special Thanks**: The WordPress community for excellent documentation and standards

**Name**: BrändiSointi means "Brand Tone" in Finnish, reflecting our mission to help you find and maintain your unique brand voice. See the
GNU General Public License for more details.

Support & Credits

Developer: Jenniina Laine (jenniina.fi)
Email: brandisointi@jenniina.fi - Plugin support and questions
Website: brandisointi.jenniina.fi
Support: Email for fastest response, or use WordPress.org support forum

Powered by: OpenAI GPT models
Name: BrändiSointi means "Brand Tone" in Finnish