Documentation in Russian: ๐ท๐บ ะ ัััะบะธะน
A component for automatically creating Joomla articles based on Kunena forum topics. Developed for Joomla 5 and Kunena 6.x.
For users of versions 1.0.4 and earlier:
If you experience automatic update errors, please manually download and install version 1.0.5 or later. This is a one-time manual update - all future updates will work automatically via Joomla's update system.
How to update manually:
- Download the latest version from Releases
- In Joomla: System โ Install โ Extensions
- Upload and install the ZIP file (it will update your existing installation)
๐ Post relations in Kunena, info block, parsing, languages | โน๏ธ Emails about article creation, database encoding, plugin | โน๏ธ Video Link Processing in the Component
The Kunena Topic to Article component (kunenatopic2article) automatically generates Joomla articles based on Kunena forum topics.
- โ Requires Joomla 5 and Kunena 6.x
- โ Works in the Joomla administrator area
- โ Tested on Joomla 5.4 / Kunena 6.3.10
- Topic ID (first post ID of the topic)ยน
- Article Category (selected from a dropdown list of site article categories)
- Post Transfer Scheme (sequential or threaded), see section 7
- Maximum Article Size (number of characters, default 40000), see section 2.2
(have "Hide" / "Show" values except for the last two)
- Post Author - determined by the topic
- Post Creation Date - taken from the post
- Post Creation Time - taken from the post
- Post Title - taken from the postยฒ
- Link to Kunena Post - shows the post index as a link, see section 4.1
- Post Relation - shows the connection between a post and its parent post (e.g., #42 โธ #35)
- Reminder Excerpt Length - number of characters shown from the parent message (0-300)
- Ignored Authors - usernames (comma-separated) whose posts are not transferred to created articles
ยน ID is displayed in the upper right corner of the post after the # sign when the "Show real post ID" option is enabled in Kunena
ยฒ Currently, Kunena defines post title as "Topic Title" or RE:"Topic Title"
Styles define the appearance of articles (default - almost standard) and the formatting of the info block.
The stylesheet /media/com_kunenatopic2article/css/kun_p2a.css can be edited in com_kunenatopic2article.zip or directly on the server without reinstalling the component.
- Install the component from the
com_kunenatopic2article.zipfile through the Joomla extensions manager - The component will automatically create the
kunenatopic2article_paramstable (one row) in the database - Additionally, a precise positioning plugin is available, see section 8
When calling the component, four buttons are available:
| Button | Purpose |
|---|---|
| โ Remember | Validates and saves parameters |
| ๐ Reset Parameters | Returns settings to defaults |
| ๐๏ธ Preview | Shows the first two posts with the info block |
| ๐ Create Articles | Generates one or more articles based on the topic |
The "Preview" and "Create Articles" buttons are activated after successful parameter saving.
- The topic author is assigned as the article author
- The first article gets the title "Topic"
- When the size limit is exceeded, articles are created with numbering: "Topic. Part 2", "Topic. Part 3", etc.
- If a single post exceeds the maximum size, an article is created containing only that post
Information is placed at the beginning of each article:
- โน๏ธ "This article is automatically generated from a similar topic on the Kunena forum of this site."
โ ๏ธ "Since both the article and the posts in the topic may be edited after the creation of this article, the correspondence between the content and design of the article and the topic may be broken."
Only the following are transferred to articles:
- Published posts (
hold = 0) - Posts by authors not listed in "Ignored Authors"
Displayed before each post if at least one of the info block parameters is enabled. When all parameters are disabled, posts are separated by a subtle line. See section 4.
- All links are preserved
- "Bare" URLs (without explanatory text) are shortened to 50 characters
- Attachment images are copied as links to these attachments in Kunena folders
- See also section 5 Parsing
After processing the topic, the following are displayed:
- Created Articles - list with IDs and article names, as well as links to them
- Emails Sent - list of email addresses to which the component sent notifications about article creation. See also section 10.
Below the article list, there are two buttons:
- ๐ Continue Work - opens the form with saved parameters (only Topic ID is reset)
- ๐ Finish Work - ends the current session
Created articles and posts in the topic "live their own lives" after the component runs and can be edited independently. The exception is links in articles to post indices, if they were created. When clicking such a link, the corresponding post on the forum opens in a neighboring browser tab. If a post is deleted after article creation, the link may stop working.
This component includes code from chriskonnertz/bbcode parser for BBCode to HTML conversion. (MIT License). Huge thanks to Chris Konnertz! The BBCode parser code remains under its original MIT License, while the rest of the component is GPL-2.0-or-later.
Of course, I am grateful to the Kunena developers, whose forum I use on my sites for many years.
If you like this project, you can make a donation via PayPal:
๐ https://paypal.me/lemiratGiCh
โก๏ธ Post relations in Kunena, info block, parsing, languages
โก๏ธ Emails about article creation, database encoding, plugin | โน๏ธ Video Link Processing in the Component