JT Article Feedback Documentation

JT Article Feedback is a Joomla! feedback extension that allows visitors to mark articles as helpful or not helpful and optionally leave a short comment. It helps website owners collect simple article-based feedback, review visitor responses, export feedback data and manage licensed Joomla! updates through JoomTheme.

Requirements

• Joomla! 6.x
• A working Joomla administrator account
• A valid JoomTheme license key for licensed updates

Package Contents

The installation package includes the following extensions:

• JT Article Feedback Component - Provides the dashboard, responses management, options and license management.
• Content - JT Article Feedback Plugin - Displays the feedback widget inside Joomla articles.
• Ajax - JT Article Feedback Plugin - Handles frontend feedback submissions.

Installation

1. Log in to your Joomla administrator panel.
2. Go to System > Install > Extensions.
3. Upload the JT Article Feedback package ZIP file.
4. After installation, go to System > Manage > Extensions.
5. Make sure the following plugins are enabled:
   • Content - JT Article Feedback
   • Ajax - JT Article Feedback

Getting Started

After installation, open Components > JT Article Feedback from the Joomla administrator menu.

From this area, you can access the main extension sections:

• Dashboard - View feedback summary and recent responses.
• Responses - Manage submitted feedback records.
• Options - Configure display, behavior and license settings.

Dashboard

The Dashboard provides a quick overview of feedback activity on your Joomla website. It helps administrators understand how visitors are reacting to articles and makes it easier to monitor recent feedback without opening each article manually.

The dashboard may display useful summary information such as total responses, helpful votes, not helpful votes, recent comments and article-based feedback activity.

Dashboard Overview

The dashboard is designed to provide a fast summary of the feedback collected from your Joomla articles.

Typical dashboard information includes:

• Total feedback responses
• Total helpful votes
• Total not helpful votes
• Recent visitor comments
• Latest submitted responses
• Related Joomla article titles
• Submission date and time

Latest Responses

The latest responses area displays recent feedback submissions from visitors. This allows administrators to quickly review new feedback and identify articles that may need improvement.

Each response may display information such as:

• Article title
• Vote type
• Visitor name, if enabled
• Visitor email, if enabled
• Comment, if enabled
• Submission date
• Status

Deleted Article Handling

If a Joomla article is permanently deleted, feedback records related to that article are also cleaned up. This prevents old feedback from deleted articles from continuing to appear in dashboard areas or feedback lists.

Responses

The Responses page lists submitted feedback records collected from Joomla articles. This page is useful for reviewing, filtering, managing and exporting visitor feedback.

Administrators can use the Responses page to understand which articles receive positive or negative feedback and to review optional visitor comments.

Response Information

Each response record may include:

• Article title
• Vote type, such as Helpful or Not helpful
• Visitor name, if the name field is enabled
• Visitor email address, if the email field is enabled
• Visitor comment, if comments are enabled
• Submission date
• Published, unpublished or trashed status

Filtering Responses

The Responses page allows administrators to filter feedback records and find specific submissions more easily.

Available filters may include:

• Search by keyword
• Filter by article
• Filter by vote type
• Filter by status
• Filter by date, where available

Managing Responses

Administrators can manage submitted feedback records directly from the Responses page.

Available actions include:

• Publish selected responses
• Unpublish selected responses
• Trash selected responses
• Delete trashed responses
• Export responses as CSV
• Search and filter feedback records

CSV Export

The CSV export feature allows administrators to download feedback records for reporting, analysis or archiving.

To export responses:

1. Go to Components > JT Article Feedback > Responses.
2. Apply filters if needed.
3. Click Export CSV.
4. Download the generated CSV file.

Options

The Options page allows administrators to configure how JT Article Feedback works on the website. Options may include frontend display settings, feedback behavior, field visibility, duplicate protection, category restrictions, dashboard settings and license management.

To access the extension options:

1. Log in to your Joomla administrator panel.
2. Go to Components > JT Article Feedback.
3. Click Options from the toolbar.

General Settings

General settings control the main behavior of the feedback extension.

Common general settings may include:

• Enable or disable the feedback system
• Select where the feedback widget should appear
• Control whether feedback is available for all articles or selected categories
• Choose the default publishing behavior for submitted responses

Frontend Display Settings

Frontend display settings control how the feedback widget appears inside Joomla articles.

Display options may include:

• Widget style
• Button style
• Feedback title or intro text
• Helpful button label
• Not helpful button label
• Thank you message after submission
• Mobile-friendly widget layout

Comment Settings

Comment settings control whether visitors can leave an additional message after selecting Helpful or Not helpful.

Comment options may include:

• Enable or disable comments
• Make comments optional or required
• Display a comment textarea after voting
• Customize the comment field label or placeholder

Visitor Information Fields

JT Article Feedback can optionally collect visitor name and email information, depending on your configuration.

Available field options may include:

• Ask for visitor name
• Make visitor name optional or required
• Ask for visitor email
• Make visitor email optional or required
• Hide name and email fields for a simpler feedback form

Duplicate Feedback Protection

Duplicate protection helps prevent the same visitor from submitting repeated feedback for the same article.

Depending on the configuration, the extension may prevent duplicate feedback using visitor session, browser data, IP address or similar checks.

Category Restrictions

Category restrictions allow administrators to control where the feedback widget should be displayed.

You can use category settings to show feedback only on selected Joomla article categories or exclude it from areas where feedback is not needed.

Dashboard Settings

Dashboard settings control how feedback information is displayed in the dashboard.

Dashboard-related options may include:

• Number of recent responses to display
• Whether unpublished responses should appear in dashboard summaries
• Whether trashed responses should be excluded from dashboard results
• Article validation for dashboard feedback records

License Settings

The License tab is used to activate, verify or deactivate your JoomTheme license.

License options include:

• License key field
• Purchase email field
• Activate License button
• Verify License button
• Deactivate License button
• License status summary
• Support expiration information
• Update expiration information

Saving Options

After changing any option, click Save or Save & Close from the Joomla toolbar. If frontend changes are not visible immediately, clear the Joomla cache and browser cache.

Frontend Feedback Widget

The frontend widget is displayed in Joomla articles when the Content - JT Article Feedback plugin is enabled.

Visitors can mark an article as:

• Helpful
• Not helpful

Depending on your configuration, visitors may also submit a name, email address or short comment.

How the Widget Works

When a visitor opens an article, the feedback widget can appear inside the article content area. The visitor can select whether the article was helpful or not helpful. If enabled, the visitor may also leave a short comment or provide name and email information.

After submitting feedback, the response is stored in the extension and can be reviewed from the Responses page.

License Activation

JT Article Feedback supports licensed Joomla updates through JoomTheme. To activate your license:

1. Go to Components > JT Article Feedback.
2. Click Options.
3. Open the License tab.
4. Enter your license key.
5. Enter the purchase email address used for your order.
6. Click Activate License.

After a successful activation, the license status should display as Valid. Licensed Joomla updates will then be available from the Joomla update system.

Verifying a License

You can verify the current license status at any time from the License tab by clicking Verify License.

The license summary displays:

• License status
• Current domain
• Support expiration date
• Update expiration date
• Site URL

Deactivating a License

If you want to move the license to another domain, deactivate it first from the old website.

1. Go to the License tab.
2. Click Deactivate License.
3. After successful deactivation, activate the license on the new website.

Joomla Updates

Once the license is active, Joomla can check for new JT Article Feedback versions using the standard Joomla update system.

1. Go to System > Update > Extensions.
2. Click Clear Cache.
3. Click Check for Updates.
4. If a new version is available, select JT Article Feedback and install the update.

The extension uses the Joomla package update system. The package element is:

pkg_jtarticlefeedback

CSV Export

Feedback responses can be exported from the Responses page.

1. Go to Components > JT Article Feedback > Responses.
2. Apply filters if needed.
3. Click Export CSV.

The exported CSV file can be used for reporting, review, customer experience analysis or internal records.

Language Support

JT Article Feedback includes English and Turkish language files.

• English: en-GB
• Turkish: tr-TR

Recommended Workflow

1. Install the JT Article Feedback package.
2. Enable the Content and Ajax plugins.
3. Open the extension Options page.
4. Configure frontend display, comments, name/email fields and category restrictions.
5. Activate your JoomTheme license.
6. Open a Joomla article on the frontend and test the feedback widget.
7. Submit a test response.
8. Check the response from Components > JT Article Feedback > Responses.
9. Review summary data from the Dashboard.

Troubleshooting

The feedback widget does not appear on articles

• Make sure the Content - JT Article Feedback plugin is enabled.
• Check the plugin settings and article/category restrictions.
• Make sure the article is published.
• Clear Joomla cache and browser cache.

Feedback cannot be submitted

• Make sure the Ajax - JT Article Feedback plugin is enabled.
• Check if your template or security extension blocks AJAX requests.
• Clear Joomla cache and test again.
• Check browser developer tools for JavaScript errors.

Responses do not appear in the dashboard

• Make sure feedback was submitted successfully from the frontend.
• Check the Responses page to confirm that records exist.
• Check whether dashboard settings or response status filters hide some records.
• Clear Joomla cache and reload the administrator area.

Old feedback appears after deleting an article

• Make sure you are using the latest version of JT Article Feedback.
• When a Joomla article is permanently deleted, related feedback records should be cleaned up automatically.
• If old records still appear, clear Joomla cache and check the Responses page.
• Update the extension to the latest version if the issue continues.

CSV export does not download

• Make sure you have permission to access the Responses page.
• Try exporting without filters first.
• Check whether your browser blocks downloads.
• Check Joomla administrator permissions if the issue continues.

License activation fails

• Check that the license key is entered correctly.
• Use the same email address used during purchase.
• Make sure your website can connect to joomtheme.com.
• If the license was previously used on another domain, deactivate it there first.

Updates do not appear

• Verify that your license is active.
• Go to System > Update > Extensions and click Clear Cache.
• Click Check for Updates.
• Make sure your update period has not expired.