



JProFeedBackJProFeedBack is a full featured feedback and testimonial, professional looking and fully customizable, component for Joomla!™ 3. It's Joomla!™ R3ADY! Your clients and visitors will trully enjoy to send you feedback!
| name: | JProFeedBack | type: | component | |
| current version: | 1.3.4 | release date: | January 2013 | |
| prev. versions: | 1.3.0 to 1.3.3 | updated on: | May 5, 2013 | |
| languages: | EN-GB | compatibility | ![]() |
|
| min.requirements: | Joomla!™ 3.0 + | |||
| bootstrap framework | ||||
| demos: | one, two | download: | JProFeedBack |
Listed on Joomla!™ Official Extensions Directory here.
JProFeedBack is a Joomla!™ 3.0 R3EADY! component
JProFeedBack is a full featured feedback component that allows you to receive feebdack from your clients/visitors in a responsive layout on your Joomla!™ 3 website. The component auto fits even on mobile devices, without loosing any functionality.
JProFeedBack is ready to be used with the unique and proprietary JProiCaptcha captcha system, specifically developed to work on Joomla!™ 3 with twitter Bootstrap framework. JProFeedBack is packed with almost every options that can be set on your Joomla!™ 3 administrator area and with extra security layers for validation, to allow safe feedback to be sent. JProFeedBack validation system uses both jQuery and PHP to ensure that the feedback is submitted correctly and safely.
The installation process is the standard Joomla!™ installation procedure and no special requirements are needed to perform a successful component installation. If you have already the JProiCaptcha plugin installed, you may set it as your default captcha and you don't need to perform any other task in the plugin manager.
One of the powerful features of JProFeedBack is that it allows you to perform extended configurations, by setting almost all kind of imaginable options on your Joomla!™ components administration area.
There are two main areas where you are able to customize your settings and tailor almost to extreme, your feedback component, including the forms and the views:
Component General configuration | Feedback Manager.
It is important that you perform the basic quick setup to render your feedback component, including the sample feedback (by JPro Extensions) that is set just as a guide to help you in your first steps.
Follow the following quick configuration guide and in few minutes you'll have your feedback component ready to receive feedback from your visitors/customers.
This is a Quick guide to the JProFeedBack component, that allows you at any time and in any any of the JProFeedBack component views, to access the global descriptions of all the possible options that are available in each area, including the configuration settings with the default values (where they exist).
Also, don't forget to add a menu to access the JProFeedBack in the front end of your website
Please set the JProFeedBack basic options before you perform any other actions. Although the default parameters are set, you may want to customize some options.
Click your Components Joomla!™ administration top menu and select the JProFeedBack component.
On the component top bar, you have the buttons:
You have now the following tabs in the JProFeedBack global configuration manager:
General
Use css updates
Select Yes if you wish to use the css updated stylesheets. This allows you to protect your customization in css files when the component is updated.
Default is No.
Receive notification?
If set Yes, the system will send a notification email about every new or edited Feedback sent/posted on your website.
Default is Yes.
Notifications for:
If you opt to receive notifications, select which type you would like to receive.
Default is All.
Use Site Address:
If set Yes, the system will use and/or override the below "Other email address" option and use the website address configured during Joomla!™ installation (System > Global configuration > Server > Mail settings) to send you the notifications if you opt to receive these notifications. Default is Yes.
Default: Yes
User name
Enter the contact's name for the notification emails.
Default is blank.
Other email address
Enter a main contact email address who will be notified about new feedback's sent. You can use just the "Use site address" above option and leave this as default - blank.
Who can send feedback?
Select which user groups can post feedback. Recommended and default is Registered. Note: Only logged in users may edit their feedback if allowed in the configuration - "Feedback's publishing".
Basis feedback min chars
Set the minimum characters the user must fill in the "Basis of feedback" field (Max characters by default in this field is 120 for layout reasons).
Default is 50
Written feedback min chars.
Set the minimum characters the user must fill in the "Written feedback" field.
Default is 200.
Written feedback Max chars.
Set the maximum characters the user will be able to fill in the "Written feedback" field.
Default is 2000.
Auto-fill Username
Select if you want to auto-fill the sender details with logged-in user details.
Default is Yes
Select no if the system shouldn't validate the session.
Default is Yes.
Use Captcha:
Whether or not to use Captcha for the form. When selecting Guests only, Captcha will not appear for logged-in users.
Default: No
Sender Details:
Select Yes, if you want to receive the senders' details in your copy of the notification emails. This option won't be included in the possible copy the user receives.
Default: Yes
Get parameters
Select Enable if you wish to display the JProFeedBack component parameters for reference or debug. This will show only in the list view in the administration area. No front-end display.
Default is Disabled.
Publishing
Define here how the feedback received is published.
Auto publish?
Select Yes if you wish to allow the feedback's to be published without review. Be aware that setting this option to Yes, might be inconvenient if users try to publish spam messages.
Default is No.
Show unpublished?
If set to Show, the unpublished feedback will be visible in the front-end, ONLY to the administrator and the user if logged in AND flagged as "Unpublished".
Default is Show.
Allow edit?
Selected Yes, if you wish to allow the user to edit their own feedback. If Yes, check the edit options below.
Default is No.
Allow delete?
Selected Yes, if you wish to allow the user to request to delete their own feedback. In this case, a notification is sent to you and the feedback is flagged as "Delete requested".
Default is No.
Edit time
If you have set the above option "Allow edit" to Yes, select the time the user will have to edit their feedback (the starting time is the date feedback was sent). If feedback has to be approved first, only the user will see the feedback to allow edit.
Default is "Until published".
Date formats
Select the date time formats for the front-end areas that display dates (ex. Date sent, edited, etc.).
Default is ex: "Thu Jan 10, 2013 05:26:24".
Send confirmation?
Select the option, if you wish to allow the user to request a confirmation that the Feedback was sent. IMPORTANT! To avoid spamming or users sending feedback with fake email addresses, this option should be set to "Logged in users only".
Default is "Logged in users only".
Message subject
Define a message subject if you have set the confirmation and/or notifications email after feedback sent.
Default is "Feedback sent on {$SITENAME}"
Message body
There are three tags that system can automatically replace with data. Use the following tags anywhere in the message body above:
{$NAME} will be replaced by the user name
{$SITENAME} will be replaced with your site name
{$SITEADDRESS} will be replaced with your www.yoursite.com address.
Photos
Define here how photos should be managed.
Request photo?
Select Yes if you wish to request the user to send you a picture to be displayed in the Feedback page.
Default is Yes.
Photo required?
Select Yes if the use must send a photo. This will validate the form before sending.
Default is No.
Label for field
Add a field label. Example: "Upload a photo".
Default is "Upload a photo"
Set image instructions
You can add additional instructions that will be placed below the file field in smaller text.
Default is blank.
Photo weight (KB)
Set the photo maximum weight in KB (kilobytes).
Default is 500.
Photo max. width (px)
Select a maximum with, in pixels, for the photo.
Default is 800px (pixels)
Photo max. height (px)
Select a maximum height, in pixels, for the photo.
Default is 800px (pixels)
Folder for photos
Select a directory where you want to store the photos sent from feedback's posts. If you need to add or change directories, just use your Joomla!™ admin media manager to add new folder. The base directory set is yoursite.com/images/feedback.
Default is "images".
Allowed file types
Select the file type(s) you want to allow the user to send. Example: "jpg,jpeg,png,TIFF".
Default is: jpg
No photo image
Select a default image to be used as "no photo available".
Please note: When changing the default "nophoto", the image filename you upload must have the work "nophoto". Example: yourimage_nophoto.png.
Otherwise, if you use the "Safe delete" option when emptying the component trash, this image will be deleted! So, rename the image before uploading and setting it as the new "nophoto" default image.
Default is jprofeedback_nophoto.png that has a transparent background.
Layout
Set your preferences for some of the back-end and front-end layout.
The front end form. The "User style" can be set by modifying the jpfb_userstyle.css file.
Back end layout
Show tooltip?
Select No to deactivate the "tooltip" and the row's left border coloring, in the list view, that flag unpublished and delete request feedback.
Default is Show.
Photo in listing
Select Show if you wish to display a thumbnail of the user photo in the feedback listing in the the administrator area.
Default is Show.
Admin comment in listing
Select Show to Show a summary of admin comment in feedback listing.
Default is Show.
Front end layout
Show limit select
If Show, the drop down that allows he user to select the number of feedback entries per page will be displayed.
Default is Show.
Order by featured?
Select Yes if the feedback listing should be order by Featured feedback or by normal ordering.
Default is Yes.
Front-end layout style
Select Yes if you wish to hide the front-end "General info" panel where the Star, Feedback ID, Year of feedback, Date sent, Publish date, Age are rendered. Default is Show.
Hide General info area
Set your preferences for some of the back-end and front-end layout.
The front end form. The "User style" can be set by modifying the jpfb_userstyle.css file.
Use sliders
This option allows you to disable the sliders/accordion style on the front-end listing. "No", means the feedback listing will be always visible. A good advise is to use the sliders if you wish to display the most options available.
Default is Yes (Use sliders).
Form position
Select where you want the form to be positioned - On top, means before the already published feedback. On bottom, means between the pagination and the already position feedback on bottom of page.
Default is Bottom.
Pre hide form?
Select Yes to pre hide the form. A link instruction will allow the form to be slided down and become visible.
Default is Yes.
Pre-hide text
Select a text to be used as instruction for the user to click and show the form, to send you the feedback.
Default is: "Click to send feedback."
Add custom top pretext?
Select Yes if you want to add any additional info that you can set below, to be displayed on the top of the Feedback page.
Default is No.
Layout pretext
Define here any additional information that may be displayed on the top of the Feedback page. Example: Send us your feedback and testimonials!
Pagination
Show or hide Pagination support. Pagination provides page links at the bottom of the page that allow the User to navigate to additional pages. These are needed if the Information will not fit on one page.
Default is Auto.
Pagination results
Show or hide pagination results information, for example, "Page 1 of 4".
Default is Show.
Layout fields
Front-end layout display options
You can deactivate the display of specific data in the front end view of each published feedback. This relates to the text. Not to the form.
User ID
Show or hide user ID.
Default is Hide.
User title
Show or hide user title.
Default is Show.
User name
Show or hide user name.
Default is Show.
User age
Show or hide user age.
Default is Show.
User email
Show or hide user email. NOTE: If user sets the email as PRIVATE it will not be shown.
Default is Hide.
User photo
Select Show to display user photo next to the feedback, if photo is available. If not available, the "nophoto" will be displayed if the option "Hide no-photo?" below is set to "No".
Default is Show (show photos).
Hide "no-photo"?
Select Yes if you wish not to display the "no-photo" image in the front-end.
Default is No (show the "no-photo").
User Company
Show or hide user company.
Default is Show.
User Website
Show or hide user website.
Default is Show.
User Website link target
User website link target.
Default is Modal.
Show user City
Show or hide user city.
Default is Show.
Show user Country
Show or hide user country.
Default is Show.
Show Year
Show or hide user's year of feedback.
Default is Show.
Show Basis of Feedback
Show or hide user's basis of feedback.
Default is Show.
Show Written Feedback
Show or hide user's written feedback.
Default is Show.
Show Internal Comment
Show or hide internal comment. Set Show if you wish to use this "Internal comment" feature as a way of replying or publicly comment the user feedback.
Default is Hide.
Integration feedback
Show or hide integration feedback. This options only works if you have set any integration to be used.
Default is Show.
Show Date Sent
Show or hide the date feedback was submitted.
Default is Show.
Show Date Edited
Show or hide the date feedback was edited.
Default is Show.
Show Featured flag
Show or hide the the flag (word or icon) that signals the feedback as featured.
Default is Hide.
Show published date
Show or hide the date the feedback was published.
Default is Show.
Form fields
This area allows you to set which form fields should be rendered in the feedback form.
"+ Required" sets the field as visible and required, meaning it should be entered and will be validated.
User title
Show or hide user title.
Default is Show.
User name
Show or hide user name.
Default is + Required.
User age
Show or hide user age.
Default is Show.
User email
Show or hide user email. NOTE: If user sets the email as PRIVATE it will not be shown.
Default is + Required.
Email private option
Show or hide the checkbox that allows the user to ask for his email not to be published.
Default is Show.
User Company
Show or hide user company.
Default is Show.
User Website
Show or hide user website.
Default is Show.
Show user City
Show or hide user city.
Default is Show.
Show user Country
Show or hide user country.
Default is Show.
Show Year
Show or hide user's year of feedback.
Default is Show.
Show Basis of Feedback
Show or hide user's basis of feedback.
Default is + Required.
Show Written Feedback
Show or hide user's written feedback.
Default is + Required.
Integration feedback
Show or hide integration feedback. This options only works if you have set any integration to be used.
Default is Show.
Show Date Sent
Show or hide the date feedback was submitted.
Default is Show.
Show Date Edited
Show or hide the date feedback was edited.
Default is Show.
Show published date
Show or hide the date the feedback was published.
Default is Show.
Redirection
Here you can set the path to where the script will be redirect after successful feedback submission. Options:
Feedback's page (recommended): redirects back to Feedback's page;
Success Page: redirect to a success page (you need to define this page content in the editor below);
Home: Redirects to the homepage;
URL: enter a valid url (http://www.mysite.com).
Redirect to:
Select where you want your users to be redirected to after submitting the form, back to the homepage, back to the form or if you want to show a custom message.
Default Feedback's page
Url:
The URL to redirect (format: http://www.mysite.com).
Default is "null"
Include message
If Yes, the below content will be displayed on top of the page of the selected option. This is ONLY for Form, and Success Page redirection.
Default Yes
Message:
Example:
Hi {$NAME},
Thank you for sending us your feedback!
Much appreciated and it will be published soon.
Help:
Use the tag {$NAME} (user name) and the system will replace the user name, sent on the form, and include in a Thank you message.
Integration
Define here if you wish to integrate a shop component
Use shop integration?
Set Yes if you wish to allow the supported shopping components integration. This is useful if you want your users to give feedback for a product or service.
Default is No.
Shop component
Select a shop component from the list of installed components on your Joomla!™ website. If set to Yes, the system will render a drop down list of products/services inside the form.
Default is none selected
Default is No.
Supported shop components are, HikaShop (com_hikashop), and JoomShopping (com_jshopping).
At the date of JProFeedBack release, only these shop components have Joomla!™ 3 compatibility.
Banned filters
Define here if you wish to apply Filters before the feedback is submitted.
Use system banned words?Select Yes if the the system should check the feedback fields against a list of more than 500 banned words used by Google and loaded in the JProFeedBack.
Banned filters are useful to avoid receiving certain type of content that you may find inappropriate or undesired.
These filters are applied after the feedback has been submitted and if matching the filters, the user is notified and the feedback contains errors and is not submitted untill the errors are corrected.
JProiCaptcha
JProiCaptcha CAPTCHA plugin is a JPro Extensions proprietary system to prevent spammers and bots from submitting forms.
It uses a double layer jQuery and PHP verification system.
You must enable and set some additional options in the plugins management.
The Captcha plugins are used to prevent spam submissions on your forms such as registration, contact and login.
You JProFeedBack package does not include the JPro Extensions proprietary captcha plugin JProiCaptcha that can be purchased here and activated before you use it here or in the overall system.
reCAPTCHA
If you don't have the reCAPTCHA keys, click here to get your free keys now.
You must enable and set some additional options in the plugins management.
The Captcha plugins are used to prevent spam submissions on your forms such as registration, contact and login.
You basic installation of Joomla includes one Captcha plugin which leverages the ReCaptcha® service but you may install other plugins connecting to different Captcha systems.
Default on: ReCaptcha
Note: ReCaptcha is a the trademark of Google Inc. and is an independent product not associated with or endorsed by the Joomla Project nor the JPro Extensions.
You will need to register and agree to the Terms of Service at Recaptcha.net to use this plugin.
Complete instructions are available if you edit the ReCaptcha plugin in the Plugin Manager.
Permissions
Default permissions used for all content in this component.
If you define that users will be allowed to edit their sent feedback, you must configure the component permissions for the user levels you wish and select the "Action" > "Edit" to "Allowed".
Example: If you wish to allow registered users to edit their feedback, select "Registered", then "Action" > "Edit" to "Allowed"
Select Components > JProFeedBack > Feedback from the drop-down menu on the back-end of your Joomla!™ installation.
This is the area where you can manage (add/edit/trash/delete) the individual Feedback records.
Important note: Whenever you "Trash" a feedback, and if you select the "Trashed" items, you'll be able to permanently delete the feedback.
Here, we added the option Safe Delete, that will also delete the correspondent image to the feedback being deleted.
If you do not wish to delete the images, but only the records, use the "Empty trash" option.
In the main view, you can order and/or filter your feedback items to easily access and select the ones you want to perform any of the allowed actions.
The layout tabs and respective fields you'll find are the following:
Feedback preview
The feedback preview tab allows you easily preview the feedback without having to visit the front end of your website. In this tab, all the information is rendered as a quick reference guide to the overall feedback, including the non public options.
As stated above, the options that are not allowed/published/rendered in the front end, will be visible here and only here and in the next "Edit feedback" tab. This is the administrator area.
Utilities
There are three useful utilities in this preview area:
The "Website preview", the "IP Address lookup" and the "Email direct link".
To access this features, click over the website link, the email link or the user IP Address, respectively.
The "Website link", opens the user website in a modal window, for preview.
The "IP Address" link, open the IP Lookup website and directly tells you, among other information, the user country/location, according with the ip address saved in the database.
The "Email direct link" allows you to click and open a new message in your email program,
Edit feedback
Introduction
This area is decided in two columns for better management of the feedback data fields. Here, all fields are displayed, no matter if you set them as "Don't show" in the component parameters. If a field is set not to be visible in the front-end of your site and you have or enter data here, it will not be displayed.
Feedback privacy
Set yes if the feedback should be private (not published). This might be useful if the user just wants to send you the feedback but not be posted on your website.
Title
A prefix or suffix added to someone's name in certain contexts. It may signify either veneration, an official position or a professional or academic qualification
Name
The user personal name. Mandatory field
Email address
The user email address used in the feedback. Mandatory field
Written feedback
The actual feedback text sent by the user.
Basis of feedback
Usually it's a summary of the user feedback related to any product/service or relation with you or your company.
Age
The user age.
Company/Organization
User's company or organization.
User
Here you can select rom the users list. Click the "User" icon and the modal window will open with your website's user list. If you wish to change this, select a user and close the modal.
ID
The feedback database record ID. Readonly
Publish
Set the publishing state of the feedback. Set Yes to publish.
Default is No.
Delete requested?
Flags a request from the user to delete his/her feedback. If you just unpublish it, the user will still see the feedback as "Unpublished". You need to change this status here or delete the feedback.
Default is No.
Featured?
Select Yes if you wish to feature this feedback. Featured feedback will be displayed on top and before other feedback.
Default is No.
Block user feedback's?
If set to Yes, if user is registered, will be blocked from submitting feedback. Note: This will NOT block te user itself. Just in the feedback form.
Default is No.
IP Address
User's IP address.Readonly
Published by
User (in admin area) that last published this feedback.
Publishing date
Date this feedback was last published/unpublished
Website
The user's website address. You should avoid prefixing the address with "http", unless strictly necessary, since the system, in the front-end, makes a real check of the website address validity when the feedback is submitted.
City
The user city/county name
Country
The user country name
Email privacy
Set by the user to ask for not publishing hes/hers email.
Default is "Private"
Year
Year relates to the year the user has used your services or purchased your products.
Photo
User uploaded photo or the default "no-photo". If you wish you can use this field to select a photo from you images directory and change/add the photo.
Language
The language used.
Default is Joomla!™ standard "All"
Edited
Flags the editing state of the feedback entry. 1 means the user has edited the feedback, 0 means not edited.Readonly
Default is 0 "Not edited".
Date edited
The date and time the feedback was edited.
Notification
Flags if the user has requested an email notification when he/she sent the feedback.Readonly
Ordering
The feedback ordering record. This comes from the "ordering/reordering" in the administration feedback's list view Readonly
Feedback comments
Show Internal Comment
Show or hide internal comment. Set Show if you wish to use this "Internal comment" feature as a way of replying or publicly comment the user feedback.
Default is Hide.
Internal Comment
Use this field to type any notes. This field will never be published in the front-end, unless you set it to yes and use this feature to thank the user or reply publicly to the user feedback.
System options
Access
This is to set the view access level for this specific feedback. If you set this differently from public, only users in the specified groups will be able to view this feedback.
Default is "Public"
JProFeedBack package does not ship with the JPro Extensions proprietary captcha plugin - JProiCaptcha.
To purchase JProiCaptcha, you can access the online shop and download it here.
Although, and if you already have it or purchase it separately, in order for the JProiCaptcha plugin to be used, it must be configured and published in the plugins manager of your Joomla! installation.
To do so, you must access the Extension Manager from the administrator top menu and search for JProiCaptcha or select Type > Plugins > Captcha
It is important that you create a menu for the component and also, before you take it live and after customizing the fields and settings, you perform some tests, by submitting feedback as test. TIP: When creating the menu for tests, set the menu access as Special, so that general users aren't able to interact with the forms before it is ready and tested.
Check how the images and render on your template and adjust it as required.
Remember that in the component global settings, you can select different styles for your front-end. If needed, there is a stylesheet - jpfb_userstyle.css, that you can use to customize your feedback component.
As it has been mentioned above, you can customize your JProFeedBack component look and feel by editing the jpfb_userstyle.css stylesheet that you should find in your Joomla!™ media folder under media/com_jprofeedback/css/ directory.
If you want to go on a deeper configuration level (not recommended for inexperienced users), create a directory on your template folder, calling it com_jprofeedback and inside, create the directory tmpl. Then copy the files default.php, form.php and update,php from components/com_jprofeedback/views/contact/tmpl/. Edit the markup of these files and Joomla!™ will override the component files.
Note that the JProFeedBack component, uses advanced object oriented programming language and the business logic to perform the most important and secure tasks is not simple.
WARNING! Only perform this level of customization if you have PHP, jQuery and HTML knowledge. JPro Extensions does not recommend this type of customization!
JPro Extensions does not sell its extensions on third party websites. Any website offering JPro Extensions products for sale are not licensed versions and must be considered scam.
Downloading JPro Extensions products from file sharing websites, like rapidshare, torrents and others, may pose your systems integrity in high risk as they may contain viruses and/or malicious code that may be extremely dangerous. Examples are database deletion, passwords, credit card and other sensitive information theft.
The prices of our extensions licenses are extremely low for you to risk your system, and the one place to purchase them is only here, at www.jproextensions.com!
Just use it!
Copyright © 2012 - 2013 JPro Extensions. All rights reserved.
Joomla!™ is Free Software released under the GNU/GPL License. Joomla™ is a trademark of Open Source Matters and the name is used under a limited license from Open Source Matters in the United States and other countries.
JPro Extensions is not affiliated with or endorsed by Open Source Matters or the Joomla!™ Project.
