GenUtils Joomla Component

Automatically receive and publish AI-generated blog posts from GenUtils.app on your Joomla website.

What is GenUtils?

GenUtils component connects your Joomla website to GenUtils.app, allowing you to automatically publish AI-generated content. When you generate a blog post in GenUtils.app, it's automatically sent to your Joomla site and published.

What You Get

• Automatic Publishing: Posts from GenUtils.app appear on your site automatically
• Full Editing Control: Edit, schedule, or unpublish any post through Joomla
• SEO Optimized: All posts include meta descriptions and keywords
• Multi-language Ready: Support for multiple languages with proper associations
• Secure: API key authentication keeps your site safe

What You Need

• Joomla 5.0 or newer installed on your website
• A GenUtils.app account

Installation

Step 1: Download

Download the latest version from the releases page.

Look for the file named com_genutils.zip.

Step 2: Install

1. Log into your Joomla administrator panel
2. Navigate to System → Manage → Install → Extensions
3. Click the Upload Package File tab
4. Select the com_genutils.zip file
5. Click Upload & Install
6. Wait for the success message

Step 3: Verify

After installation:

1. Look for the success message
2. Check that Components → GenUtils appears in your admin menu

Setup

Step 1: Get Your API Key from GenUtils.app

1. Log into your GenUtils.app account
2. Go to your website settings or integrations page
3. Generate a new API key for your Joomla site
4. Copy the API key (you'll need it in the next step)

Step 2: Add API Key to Joomla

1. In Joomla, go to System → Manage → Components
2. Find GenUtils and click Options
3. Paste your API key from GenUtils.app into the API Key field
4. Click Save & Close

Step 3: Configure Settings (Optional)

While you're in Options, you can adjust:

Auto Publish

• Yes (recommended): New posts appear immediately
• No: Posts are saved as drafts for you to review first

Default Language

• Choose your site's main language
• Posts will use this language unless GenUtils.app specifies otherwise

Log Webhooks

• Yes (recommended): Keep records of posts received for troubleshooting
• Logs are automatically cleaned up after 30 days

Connect to GenUtils.app

Step 1: Get Your Webhook URL

Your webhook URL is:

https://your-site.com/index.php?option=com_genutils&task=webhook.receive

Replace your-site.com with your actual website domain.

Example: If your site is https://myblog.com, your webhook URL is:

https://myblog.com/index.php?option=com_genutils&task=webhook.receive

Step 2: Add to GenUtils.app

1. Log into your GenUtils.app account
2. Go to your website settings
3. Find the Joomla Integration or Webhook section
4. Enter:
   • Webhook URL: Your webhook URL from Step 1
   • API Key: The API key you created in Joomla
5. Save your settings

Step 3: Test It

Generate a blog post in GenUtils.app and it should automatically appear in your Joomla site!

Check Components → GenUtils → Posts to see it.

Managing Your Posts

Viewing Posts

Go to Components → GenUtils → Posts to see all posts received from GenUtils.app.

You can:

• Search for posts by title
• Filter by published/unpublished status
• Filter by language
• Sort by date, title, or views

Editing a Post

1. Click on any post title
2. Edit the content, title, or meta description
3. Click Save

What you can change:

• Title
• Content (the blog post text)
• Meta description (for SEO)
• Keywords
• Language
• Publication status (published/unpublished)
• Schedule when to publish or unpublish

Publishing Control

To unpublish a post (make it invisible on your site):

• Click the green checkmark next to the post in the list

To publish a post:

• Click the red X next to the post in the list

To schedule a post:

1. Edit the post
2. Set "Publish Up" to when you want it to go live
3. Optionally set "Publish Down" to when it should disappear
4. Save

Deleting Posts

1. Check the box next to one or more posts
2. Click the Trash icon at the top
3. Confirm deletion

Note: Deleted posts are permanently removed and cannot be recovered.

Displaying Posts on Your Website

Create a Blog Page

To show your posts on your website:

1. Go to Menus → Main Menu → Add New Menu Item
2. Give it a title (e.g., "Blog")
3. Click Select next to "Menu Item Type"
4. Choose GenUtils → Posts
5. Click Save & Close

Now your visitors can see all published posts by clicking the "Blog" menu item!

Customize What's Shown

When editing your menu item, you can choose to show or hide:

• Publication dates
• Author names
• View counts
• Post titles

Adjust these settings in the menu item options to match your site's style.

Common Issues

Posts aren't appearing from GenUtils.app

Check your API key:

1. Go to System → Manage → Components → GenUtils → Options
2. Verify the API Key matches what you entered in GenUtils.app
3. Make sure there are no extra spaces

Check your webhook URL: Make sure you're using the correct format:

https://your-site.com/index.php?option=com_genutils&task=webhook.receive

In GenUtils.app:

1. Check the webhook status - it should show successful deliveries
2. Look for any error messages

Posts are being created but not showing on my site

Check if the post is published:

1. Go to Components → GenUtils → Posts
2. Look for a green checkmark next to your post
3. If it shows a red X, click it to publish

Check your blog menu:

1. Make sure you created a menu item (see "Displaying Posts" section above)
2. Verify the menu item is published

I want to stop auto-publishing

If you want to review posts before they go live:

1. Go to System → Manage → Components → GenUtils → Options
2. Change Auto Publish to No
3. Save

Now posts will be saved as drafts. You'll need to manually publish them from Components → GenUtils → Posts.

Need Help?

GenUtils.app Support: Visit https://genutils.app for help with GenUtils.app settings

Joomla Issues: If you need help with Joomla itself, check https://docs.joomla.org

Component Issues: Report problems at https://github.com/genutils/genutils-joomla/issues

Updates

New versions are released regularly with improvements and bug fixes.

To check for updates:

1. Go to Extensions → Manage → Update
2. If an update is available, click Update to install

---

That's it! You're ready to start publishing AI-generated content on your Joomla website with GenUtils.