WP Manifestindependent plugin directory
manifest / social / gt-content-table

GT Mention Tracker

Track and manage article mentions from Gutenberg Times newsletters with automated social media posting.

by Birgit Pauli-Haack · github.com/bph/gt-content-table · 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/bph/gt-content-table/archive/refs/heads/main.zip

Readme

GT Mention Tracker

A WordPress plugin to track and manage article mentions from Gutenberg Times newsletters with automated social media posting.

Features

  • 🔍 AI-Powered Content Parsing - Automatically extracts article mentions from newsletter content using OpenAI
  • 📊 Modern Admin Interface - Built with React and WordPress DataViews for intuitive management
  • 🐦 Twitter Integration - Automated social media post generation and scheduling
  • 📈 Analytics & Tracking - Monitor engagement and author mention statistics
  • 🔄 Historical Import - Process existing newsletters in manageable batches
  • 👥 Author Management - Track social handles and manage duplicate authors

Requirements

  • WordPress 6.0+
  • PHP 8.0+
  • Node.js 18+ (for development)
  • OpenAI API key
  • Twitter API credentials (optional)

Installation

  1. Clone or download this repository to your WordPress plugins directory
  2. Run npm install to install dependencies
  3. Run npm run build to build the assets
  4. Activate the plugin in WordPress admin
  5. Configure API keys in GT Mentions > Settings

Development

Setup

# Install dependencies
npm install

# Start development server with hot reloading
npm run dev

# Build for production
npm run build

# Lint JavaScript
npm run lint:js

# Lint CSS
npm run lint:css

# Format code
npm run format

Project Structure

gt-mention-tracker/
├── build/                 # Built assets (generated)
├── src/                   # Source files
│   ├── components/        # React components
│   ├── index.js          # Entry point
│   └── style.scss        # Main styles
├── includes/             # PHP classes
├── assets/               # Fallback assets
└── templates/            # PHP templates

Build Process

This plugin uses @wordpress/scripts for modern WordPress development:

  • Development: npm run dev - Watches files and rebuilds automatically
  • Production: npm run build - Optimized build with minification
  • JSX Support: Write React components with JSX syntax
  • SCSS Support: Use modern CSS with Sass preprocessing
  • Translation Ready: Strings are extracted for internationalization

Configuration

OpenAI API

  1. Get an API key from OpenAI Platform
  2. Add it in GT Mentions > Settings > OpenAI API Configuration

Twitter API

  1. Create an app at Twitter Developer Portal
  2. Generate API keys and access tokens
  3. Configure in GT Mentions > Settings > Twitter API Configuration
  4. Test the connection using the provided button

Usage

Automatic Processing

When enabled in settings, the plugin automatically:

  1. Processes new newsletter posts when published
  2. Extracts article mentions using AI
  3. Creates author profiles and article records
  4. Generates social media post drafts

Manual Import

Use GT Mentions > Import History to process existing newsletters:

  1. Set date range or specific post IDs
  2. Configure batch size (recommended: 5-10)
  3. Monitor progress and handle any errors
  4. Resume interrupted imports

Content Management

Mentions Page: Review, edit, and approve extracted mentions Authors Page: Manage author profiles and social handles

Social Media

  • Generate social post drafts automatically
  • Schedule posts with configurable delays
  • Track engagement metrics
  • Bulk operations for efficiency

API Integration

Content Parsing Prompt

The plugin uses a sophisticated prompt to extract mentions:

  • Filters out plugin/theme directory links
  • Includes WordPress.org developer content
  • Validates URLs and author names
  • Handles edge cases and duplicates

Social Post Generation

AI-generated social posts include:

  • Engaging copy highlighting article value
  • Author mentions with Twitter handles
  • Relevant hashtags (#WordPress, #Gutenberg, etc.)
  • Character limit optimization

Security

  • All AJAX requests use WordPress nonces
  • Capability checks for admin functions
  • Sanitized input and output
  • Secure API credential storage
  • No sensitive data in JavaScript

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Run tests and linting
  5. Submit a pull request

Troubleshooting

Build Issues

# Clear node modules and reinstall
rm -rf node_modules package-lock.json
npm install

# Check Node.js version
node --version  # Should be 18+

API Issues

  • Verify API keys are correctly entered
  • Check API rate limits and usage
  • Review error logs in WordPress admin
  • Test connections using built-in tools

License

GPL v2 or later - see LICENSE file for details.

Support

Made with ❤️ for the WordPress community by Birgit Pauli-Haack

Read the full README on GitHub →