AJAX commenting system - SVN
Contents
1. Prefix to table map gt PREFIXMAP Comments extension must know the table name of the commented record The extension s configuration contains a map of triggering prefix names to table names By default it looks like prefixToTableMap tx albumsx pil tx album3x images prefixToTableMap tx commerce pil tx commerce products prefixTotTableMap tx irfaq pil tx irfaq q prefixToTableMap tx mininews pil tx mininews news prefixToTableMap tx ttnews tt news prefixToTableMap tt products tt products Extension authors who want to enable commenting on their records may add entries to setup txt if their own extension to extend this map Here is an example how it should be done plugin toctoc comments pil prefixToTableMap tx myext pil tx myext mytable So if URL looks like this http domain tld index php id 12345 amp tx myext pil showUid 67890 than comments extension will understand that it must refer to tx_myextmytable for triggering prefix tx_myext_pi1 showUid map gt SHOWUIDMAP Some old extensions use names other than showUid to refer to a single record Our extension needs to know this name to find the record s uid By default tt_news and tt_products are configured Here is how default map looks like showUidMap tx ttnews tt_news showUidMap tt products product All new extensions should use showUid parameter But it is possible to use custom parameter with comments extension H2. typo3conf ext toctoc comments resources jquery 1 7 2 min js JQuery versions 1 7 are not compatible with lightboxes which use brackets in their rel aAttributes If possible just change the brackets to parentheses Some lightboxes accept this This is a TYPO3 6 0 issue because TYPO3 6 0 will fully support only jQuery 1 7 Also the Share function needs Jquery 1 7 to function properly older versions cannot display the number of shares correctly 3 Setup your TS See setup txt in directory static for an example Important is to set the constant for the StoragePID the pid of the folder where comments will be stored TS Setup can be very minimal see the example above for logged in and anonymous users this is the recommended minimal setup Upgrading from comments 15 x You need to enable the upgrade mode in the extension setup in Extension Manager The comments and ratings for comments on a page are imported in toctoc_comments regardless of their original storage folder id Inserting AJAX comments to page When inserting a new content element scroll down to the end of New content element wizard and click on the AJAX Commenting system AJAZ Commenting system JA based ratings for TocToc Comments This will insert a plugin for AJAX commenting system as a new content element Alternatively you can inject the plugin by TS in a templavoila FCE Use in templavoila In a flexible content element
3. of voting bar maxValue integer Maximum rating value This must not be changed once ratings are in use 5 already Changing this value also requires CSS adjustments length of voting bar ratinglmageWidth integer Width of a single rating bar image Must be adjustted if a non default 11 image is used mode auto or static auto means that ratings will operate as they normally do on web sites auto user votes and he cannot vote on this item any more static means that the user will not be able to vote ratings will be read only disablelpCheck boolean Disables the IP address check for votings If this check is disabled users 0 may vote any number of times on the item useful for testing Notice users will have to reload the page to vote again additionalCSS string Allows to change the appearance of ratings without changing template Typically ratinglmageWidth needs to be changed too ratings TemplateFile string Template file for ratings shown in the plugin Accepts either site relative EXT toctoc_com path or extension related path EXT prefix ments res templat e toctoccomment s_ratings html useMyVote boolean Show the vote of the user 1 useVotes boolean Shows the rating stars and enables voting if checked 1 useLikeDislike boolean Show Like and Dislike Features if checked both are active 1 useDislike boolean Show Dislike Features makes only sense in connection with 1 useLikeDislike
4. AJAX commenting system A plugin for an enhanced social user experience covering commenting rating and sharing V 2 1 0 Extension Key toctoc_comments Copyright 2012 gisele wendl toctoc ch lt gisele wendl toctoc ch gt TocToc Internetmanagement This document is published under the Open Content License available from http www opencontent org opl shtml The content of this document is related to TYPO3 a GNU GPL CMS Framework available from www typo3 com Table of Contents AJAX commenting system Sere devia duane sas 1 Prefix to table map gt PREFIXMAP 00008 19 introductionis aa 3 showUid map gt SHOWUIDMAP sssssrirrisssssssssn 19 Wat does da2 i 3 Organisation Of fil S cccceeeseeeeeeeeeeeeeeeeeeeneeeeees 20 FS NS cs ccstesdase soot sexe cas ceneee tector etevoeneienaton 3 JavaScript oo esses eet ieee tenet ntneatente 20 Saree e Glee cee ec ceca cde sich ee cect ccs 5 SQUETY ccceeeccccccccceceeeeeeeaseeeeeeeseeeeeeeeeeeseesaeeeeeeeeeenas 20 Acknowledgments ee ee ee es 7 CSS eee eee ee ee ee ee ee ee ee ee ee 20 Having QUeStiONS cccccscsssecssessssssessesssesseestesseseeseeses 7 VMAS S torts E E E A E 20 Users TU ANNU A i enetensscetancaannca dence eesGucawantatsneanaueuceetusuarwieese 8 TEMPIAte eeseeeeseee teeter teen ietteeteeteas 20 Installing ANd SetuP cc cccccceeceeceeeeeeeeeeeeseeeeeeees 8 Fonts for the Captchas sees 20 Inserting AJAX commen
5. In boolean Use of Share Link for LinkedIn is suppressed 1 dontUseSharingStumbleupo boolean Use of Share Link for Stumbleupon is suppressed 1 n Spam protection gt SPAMPROTECT Property Data type Description Default requireApproval boolean If enabled messages will be set to disapproved state and notification will 1 be sent to administrator see notificationEmail below If approval is not requested but checkTypicalSpam is set messages still can be set to disapproved state and notification is sent useCaptcha string Enables using captcha to post comments Possible values are 0 None 0 sr_freecap clone captcha extension 1 jm_recaptcha clone extension 2 Captcha is checked after submit freecapBackgoundcolor string freecaptcha clone Backgoundcolor Use valid rgb code like 225 225 225 255 255 255 freecapTextcolor string freecaptcha clone textcolor Use valid rgb code like 25 25 25 95 107 200 freecapNumberchars Int Number of characters freecaptcha clone max is 10 min is 3 4 freecapHeight Int Height for freecaptcha clone max is 50 min is 23 23 checkT ypicalSpam boolean If set extension automatically checks all comments for typical guestbook 1 spam If comments receives more than the value of spamCutOffPoint spam points it is automatically set to disapproved state and notification is sent to the author in the plugin considerReferer boolean If set checks that referer of the current page is within the same web site 0 If
6. The commenting system itself is very flexible many options can be set It can be used as commenting system and or as rating system This extension can import comments from extension comments it is an UPDATE This extension is presented to the TYPO3 community by TocToc Internetmanagement www toctoc ch Features Extension has the following features Comment content elements Comment records Comments are displayed in its own content element they refer to the content element before the comments or if only one toctoc_comments is on a page then its for the page 3 highly customizable templates O 2 templates for commenting one for fe_users who are logged on one for anonymous website visitors O 1 template for ratings O CSS for every element and optional additional CSS file O Markers for all fe_user fields Available fields for comments labels can be customized First name Last name E mail Home page Location city for example O O O O O Comment Set fields as required or optional E mail address syntax validation Fully localizable including date format through PHP strtoftime function Automatically clear cache for any page s when comment is added Close comments after predefined period Close comments for individual records immediately or after period Prevent duplicate comments for example several subsequent POST requests See IP address of the commenter in BE Import messages from extension com
7. able ratings Use TypoScript setting Template file for ratings use voting and show rating stars Use TypoScript setting use My vote Use TypoScript setting use iLike AMD iDislike Use TypoScript setting use or don t use iDislike Use TypoScript setting Enable only Ratings suppresses the display of comments sharing is not touched enable ratings allows to enable or disable all rating functions voting and liking Template file for ratings Allows to specify a different ratings layout use voting and show rating stars enables basic rating use My vote shows the users individual vote per IP if logged out per fe_user if logged in use iLike AND iDislike enables to basic use of the like feature Both like and dislike are activated use or don t use iDislike allows to hide the dislike feature AJAX commenting system 11 Anti spam tab General Adyanced Rating options Anti spam Require approval of each comment Use TypoScript setting Check referrer Use TypoScript setting Use captcha Use TypoScript setting Send notification to this e mail Send e mail fram this address Template file for e mails Require approval of each comment triggers the email for administrator wnere he can approve or disapprove a comment Check referrer is an option for more control on posts the referrer of the post must be on the site itself Use captcha enable use of capcha r
8. array is prepared for displaying a single comment in a list Parameters Argument Type Description template string Template subsection to be used markers array Existing markers row array Current comment row Hook should return a modified array with markers form This hook is called when marker array is prepared for displaying form Parameters Argument Type Description template string Template subsection to be used markers array Existing markers Hook should return a modified array with markers processSubmission This hook is executed before record is inserted into database Argument Type Description record array Record array Hook should return a modified record array sendNotificationMail This hook is called when marker array is prepared for sending e mail notification to administrator Parameters Argument Type Description template string Template subsection to be used check string Hashed check value for elD call markers array Existing markers Hook should return a modified array with markers Translating the extension Translation of the extension happens in future only through translation server If you do not know what translation server is read about it here Until we have access to it you ll find available translations on www toctoc ch toctoc_comments_Il html To Do list Picture upload display Comm
9. cle or a comment Dislike an article or a comment Delete a comment Add a comment Check the Captcha Set the Captcha Browse for older comments Hide older comments Show user card jQuery serves for Sharings makes the inputbox for comments elastic creates the usercards and helps to resize the commenting area S SESSION Variables The extension uses many S_SESSION variables for program control and performance optimization AJAX commenting system 19 Using AJAX comments in other extensions tt_news Comments extension provides custom marker for tt_news to display number of comments inside LIST LATEST or SEARCH views Marker is TX_ COMMENTS COUNT By default it will produce the following HTML lt a href url to news item tx toctoc comments comments UID class tx toctoc comments count gt 5 comments s lt span gt This HTML can be customized by modifying template supplied with toctoc_comments extension See HHETTNEWS COMMENT COUNT SUB subpart in the template tt_news marker is typically included after more link Known problems Not made for big sites like facebook we re working on it Hooks Using hooks This section explains how to use hooks inside Comments extension and lists all available hooks New hooks can installed using the following code in ext_localconf php of another extension STYPO3 CONF VARS EXTCONF toctoc comments hookName yourextkey EXT yourextkey class tx yourext
10. egardless if the user is logged in or not Send notification to this e mail allows to specify a recipient other than in TS setup for approval emails about new comments Send e mail from this address allows to specify another sender e mail than specified in TS setup Template file for e mails allows to make individual e mails contents AJAX commenting system 12 Approving comments If a comment is set to disapproved it may be because it is spam or the Require approval of each comment option is set These comments will not be visible on the page E Mail approval The administrator will receive e mail with links to approve delete or kill delete permanently comments Administration of comments can be done also through Web gt List module ot the Web gt Comments module Approval by Web gt List module This is the normal TYPO3 Listmode where you have the records and then you can edit them like any other records Here disapproved comments have different icon in the List module El Ein Nebenaspekt unter WIMP sin es Ganz und gar nicht sein lassen k The first item on the screenshot above shows a comment which has not been approved yet When opened for editing the following flag will define if comment is approved Approval state Fi If check is set comment is approved Approval by Web gt Comments module In the BE module of comments you can approve delete hide and kill comments on a list For mass adminis
11. ents on comments Better BE for Comments including Per User View Activity Reports Dashboard and Ratings administration Configuration options for the look of the freecap clone some of them are already quite easily accessible thru the variable values in class toctoc_comments_ajax php Configuration for selecting a recapcha clone theme currently pictures are available as sub directories in res img and as presets in res css toctoccomments_pi1 css AJAX commenting system 21
12. ere is an example plugin toctoc comments pil showUidMap tx myext pil uid AJAX commenting system 18 So if URL looks like this http domain tld index php id 12345 amp tx myext pil uid 67890 than comments extension will understand that record s uid value is 67890 Organisation of files Javascript There s one JS File for all the comment and ratings specific tasks it s included in the header of the page automatically from the template res js holds all the js files for the jQuery Extensions JQuery It s up to the programmer who put the extension in your site to link the jQuery File We deliver a working version 1 7 2 in directory resources if you don t have use it already Note Lightboxes often use the rel sometext index syntax in the href tags Newer versions of jQuery do not support the brackets anymore To make it work again make the brackets disappear CSS CSS is used excessively in this extension CSS files are in directory res css Images res images Templates res templates Fonts for the Captchas pi1 fonts Smilies res smilie Code Concepts Extension architecture This extension is still build in the classic approach as pi1 Extension It does not yet support Fluid and Extbase nor a domain model We re working on that for future releases AJAX Events The plugin handles the following events Vote an article or a comment article stand for what we re commenting on Like an arti
13. for Location field wrap content_stdWrap array Wrap for Content field wrap Options for smilies smiliePath string Path to directory with smiley image files EXT toctoc_comments res smilie fileExt string file extension of smiley images png AJAX commenting system 15 like the famous developer Putnam from facebook dedicated to the related living persons who contributed to this extension pacman squint devil 3 frown cry robot heart angel kiki _ penguin gisele jacque roman r 6 7 8 9 10 L1 12 L3 14 15 17 oOo A ee e W U loot ot N l Cp 09 unsure Property Data type Description Default smilies array Array with all available smilies defined swdle p 2 J Longue lt F 0 P Syntax wink filename stringl string2 grin D D D curlylips 3 Smilies are a mix from facebook like smilies and the lt SS a a smilies from the original smilie extension Smilies ee ae oe Be gt gisele Gis le Wendl Roman and Jacqueline are just 9 259589 9 F sunglasses 8 8 B B upset gt 10 Si O gt 10 gt 1 70 confused 0 0 0 0 shark gasp 0 putnam putnam 80 8 0 8o 8 0 Advanced options gt ADVANCED Property Data type Description Default closeCommentsAfter string If set automatically disables commenting for items older than t
14. his period See Close commenting after in the User manual for more information Setup only option empty commentingClosed Commenting can be totally suppressed O default or 1 dateFormat string Defines date format to use for date time information about posts Format specifiers depend on dateFormatMode configuration option See PHP function date and strftime for information about format specifiers If empty defaults to concatenation of SYS gt ddmmyy and SYS gt hhmm system variables from Install tool and dateFormatMode is foreced to date empty dateFormatMode string Determines what PHP function to use for date formatting Defaults to date If you want to use month or week days in national language you have to use strftime Valid values are date strftime date dateFormatOldStyle boolean Use old style date format Old style date format is like 20 08 2012 new style would be like 3 weeks and 4 days ago See dateFormatMode and dateFormat for old style autoConvertLinks boolean If enabled will search for possible links in comment text and turn them to links Specifically the following texts are searched http www Anything that starts from these strings and till next space will be converted to links This procedure is not very clever but works in most cases Links are always created with rel nofollow and css class tx comments external autol
15. ink There is no way to change any of these two attributes CommentsShowOldPerCID Int This is the scrolling multiplicator telling how many commentsPerPage the show older comments function reveals at a time UseTemplavoilaField string Name of the field defined in templavoila if used where the comments plugins goes Check your templavoila page template field_ content AJAX commenting system 16 Property Data type Description Default UseMainColPos int tt_content Column colPos with comments plugins 0 Columnposition colPos where the comments plugins go Can be left on 0 most of the times FeUserlmagePath string Path where the feuser images are stored Normally uploads pics uploads pics FeUserlmageStyle string Additionional style information applied on the img tag of the feuser image padding 0 in a comment border radius 2px 2px 2px 2px border 1px solid 97b0ee useSharing boolean Use of Share Links for social networks like Facebook Google and Twitter 1 useSharingDesign int Use Design with default or without buttons 0 Default 0 Buttons 1 dontUseSharingFacebook boolean Use of Share Link for Facebook is suppressed 0 dontUseSharingGoogle boolean Use of Share Link for Google is suppressed 0 dontUseSharingTwitter boolean Use of Share Link for Twitter is suppressed 0 dontUseSharingLinked
16. is obtained by selecting nothing storagePid int Page uid where comment records will be stored empty value of Current page if empty plugin toctoc_comments_pi1 stor agePid constant externalPrefix string See Triggering prefix in User guide pages the value of plugin toctoc_comments_pi1 exter nalPrefix constant templateFile string Template file for the plugin Accepts either site relative EXT toctoc_comments res template path or extension related path EXT prefix toctoccomments_template html value of plugin toctoc_comments_pi1 tem plateFile constant DeleteCommentimage string Icon to display for comment deletion size will be EXT toctoc_comments res img dele 16x16 tecommentfe png DefaultUserlmage string Image to display for not logged in commentators EXT toctoc_comments res img profi le png UserlmageSize int Size of user image in pixels Image will be cropped 32 from the center of the original image square commentsPerPage int Number of comments show in a comments list 3 value of plugin toctoc_comments_pi1 com mentsPerPage constant minCommentLength int Required length for a comment 48 userStats boolean Create and maintain userstatistics Check this option if 1 you want to create statictis for each user leaving comments or making ratings Slower but better control AJAX commenting system 14 Property Data type Description Defa
17. key hooks php amp tx yourextkey hooks gt methodName Notice that you can freely choose method name for the hook Common hook parameters Each hook receives two arguments Argument Type Description amp params array Contains hook parameters specific for each hook see hooks list below and pObj which is identical to pObj hook parameter amp pObj toctoc_comments Reference to calling class Notice that you should have amp before this parameter name _ pit List of hooks Section name in this chapter corresponds to hookName in section Using hooks mergeConfiguration This hook allows to alter add configuration values for toctoc_comments_pi1 There are no additional parameters to the hook Hook should modify configuration in the following way pObj gt conf section param value elD_postProc This hook is called by elD script when comments extension approves or deleted comment using link in notificatiion e mail It allows to post process e mail commands Hook does not receive any custom parameters AJAX commenting system 20 comments This hook is called when marker array is prepared for displaying comments list as whole Parameters Argument Type Description template string Template subsection to be used markers array Existing markers Hook should return a modified array with markers comments_getComments This hook is called when marker
18. lugin instance So for example you can deactivate sharing in general TS configuration and activate it only in the first plugin on a page Plugin configuration consists from several tabs General tab Selected Plugin J Gi AAs Commenting system Plugin Options General Advanced Rating options Anti spam Mode Selected Items Available Items Comment listing Comment listing Comment form Comment form Triggering prefix Store records at page ac E l Page ka Enable User Statistics Use TypoScript setting Mode defines what the plugin displays comment listing and or form to add comments Triggering prefix defines what parameter in URL triggers displaying of comments The value depends on another plugin and its parameters Typically this parameter will be tx_extkey_pi1 but some older plugins have different values for example tx_ttnews for tt news plugin Special value pages allows to comment on content elements on a page instead of records Note for plugin authors read Configuration section on information about enabling comments for your extension Storage page specifies where records should be stored If empty current page is used Enable User Statistics is for more control over the stats here you could enable it just for the concerned plugin What is a User There are 2 kinds of users Anonymous and logged i
19. me Notice your message has been recorded and will appear as soon as itis approved by moderator After the captcha has been resolved the comment has been recorded in the database As option require approval is active the comment will be first presented to the administrator who has to approve delete or kill the comment kill deletes a comment permanently from the database Many other scenarios apply Different look for logged in users When a user is logged in the fields to enter first name last name email location are hidden and prefilled with the values form the users profile This is handled with a template In the template file for comments there are 2 subtemplates one for logged in users one for IP users not logged in Handling in TS Setup is best done with conditional assignment of option in setup Often used is the encore captcha approval for anonymous IP users and let fe_users post without further conotrl Have a look at this TS Setup usergroup plugin tx Tocrocconmments pil ratings enableRatings 1 useDislike 1 AJAX commenting system 5 spamProtect requireApproval 0 useCaptcha 0 else plugin tx toctoccomments pil ratings 4 enableRatings 1 useDislike 0 spamProtect requireApproval 1 useCaptcha 1 global Acknowledgments Creation of this extension was sponsored by TocToc Internetmanagement an international TYPO3 company from Swi
20. ments Spam control Captcha use sr_freecap clone or recaptcha clone Filter out typical guestbook spam Force all messages to pass approval Automatically decide if message should be approved before it can appear on the web page Send e mail to designated e mail address about suspicious messages O O O O O internal spam checker Spam filter can be set up with spam words in the BE Full TYPO3 caching supported USER object which highly improves web site performance Automatic cleanup removes comments and ratings if parent record is removed External CSS style sheet can be included through the template no need to modify web site TS setup for this Automatically use FE user data to fill comment form AJAX commenting system 2 Extends tt_news to show number of comments in LIST SEARCH and LATEST views Integrates ratings internally Integrates smilies internally Automatically find links in comment text and convert them to clickable links can be turned on and off Share comments on social platforms like Facebook Twitter Google Shows pop up cards with user information New in 2 1 Set the required length for comments 2 sharing Design with Buttons Counter 4 Options to setup the srfreecap clone captcha AJAX commenting system 3 Screenshotes There are screenshots also in other sections of this manual This screenshots shows the default template with default styles and ratings enabled Default templa
21. n users Logged in users FE Users are stored in format 0 0 0 0 fe_userid example 0 0 0 0 2054 Anonymous users are identified by their IP address So the format for anonymous users is IP 0 example 184 126 45 22 0 AJAX commenting system 9 Advanced tab General dvanced Rating options Close commenting after Commenting closed for this plugin instance Use TypoScript setting use Sharing Use TypoScript setting don t use Sharing for Facebook Use TypoScript setting don t use Sharing for Google Use TypoScript setting don t use Sharing for Twitter Use TypoScript setting don t use Sharing for LinkedIn Use TypoScript setting don t use Sharing for Stumbleupon Use TypoScript setting Close commenting after allows to automatically disable commenting if record is older than specified time period Time period is a number followed by suffix Suffix can be h hour m month y year or d day Comments extension takes care to change page caching time so that page cache expires when comments should be closed Commenting closed for this plugin instance allows to close commenting immediately Use Sharing enables the sharing function in the plugin don t use sharing disables the Sharing function for a given platform individually AJAX commenting system 10 Rating options tab General Advanced Rating options Anti spam enable only Ratings Use TypoScript setting En
22. not message is set to disapproved state and notification is sent to administrator notificationEmail string E mail address to send notifications to informationEmail string Notify administrator about posted comment without approval by e mail fromEmail string E mail address to send notifications from emailTemplate string Template to use for Approval needed notification email to administrator It EXT toctoc_com will result in a simple ext lt E mail ments res templat e toctoccomment s template email txt emailTemplatelnfo string Template to use for information notification email to administrator emailTemplatelnf O EXT toctoc_com ments res templat e toctoccomment s_ template email info txt spamCutOffPoint integer If number of points is greater than this value new comment is ignored 10 user receives spam warning message and e mail to administrator is not sent AJAX commenting system 17 Ratings gt RATINGS Property Data type Description Default enableRatings boolean Enables web site visitors to rate comments Notice that ratings change is 0 only available if comments are not closed for the item When comments are closed ratings automatically become read only ratingsOnly boolean Enable ratings only Use plugin as rating only version 0 minValue integer Minimum rating value This must not be changed once ratings are in use 1 already Changing this value also requires CSS adjustments length
23. of templavoila you can setup TS for a mapped element It s possible to use the plugin in a FCE flexible content element AJAX commenting system 7 Setup the element as TypoScript only element Element Preset Mone Typoscript only Changing element type will change your existing settings Mapping rules The TS you need looks like this 10 USER_INT LO lt plugint TOCLOCCOMments pil EL Element T poScript Constants field content 2 ve Configuration Data processing TypoScript Code 10 USER INT 10 lt plugin tx toctoccorments pil Update Cancel Close eG AJAX commenting system 8 Customizing comments All comments options should be configured first sitewide through a TypoScript Template Then some of the options setup in TS can be overwritten through the plugin s configuration when it is inserted as content element TypoScript configuration is the only possibility for configuration if the plugin is inserted through TypoScript setup for example as TypoScript object path in TemplaVoila or as a part of flexible content element For information on TypoScript configuration see Configuration section later in this manual Important Flexform configuration always overrides TypoScript configuration when a field is set to some value The choice which options are available in the plugin was guided by the importance to have an option individually setup in a specific p
24. te has many CSS classes which allows very customizable styling Unsere Empfehlung Share 0 TYPO3 f r Amter Beh rden und Gemeinden The plugin used in this screenshot shows only just the active options iLike voting and sharing genutzt werden Wke Comment Share oO a Gisele Wendi Ich sch tze besonders die mutige Umsetzung Mia von HTMLS O Wegbereiter der Zukunft Danke months 3 weeks ago trertverty Rating 4 3 of 5 3 votets ri Like Add comment Welterfuhrende Links Download amp Installation Hilfe Like Comment ie Gis le Wendl und weitere Beispiele f r s Kormmentar Plugin F unter http www readysite ch elemente bedienung tabellen 2 months 3 weeks ago PWereviriy Rating 3 0 of 5 1 votets EJ Like Add comment AJAX commenting system 4 Here you can see 2 plugins on a page Sharing is deactivated in the second plugin In the second plugin you can see a link and a smilie also this can be activated or deactivaed Please resolve this Captcha My new comment I think HTMILS will simplify the creation of webpages radically Dashka Bronjovk dashkat hotmail carn WSYX OTYV Enter the captcha CAPTCHA atop spam ead books Submit After posting a comment the useCaptcha option brings the captchas security question Here the recaptcha clone has been configured with the white the
25. tration this is the easiest way FAQ None yet Ask in the TYPO3 mailing lists AJAX commenting system 13 Administration Adding TypoScript template The extension s TypoScript template must be added to site s TypoScript template To add this template go to Template submodule of Web module click on the Info Modify there and click Click here to edit whole template record link In the opened form scroll down to Include static from extensions and click AJAX Commenting system toctoc_comments in the right box It should appear in the left box General Options 414 Commenting system toctoc_comments Includes Edit Template plugin xxx on page extension_configuration Resources Access Include Static Templates After Basis Templates Include static from extensions Selected Items Available Items 15 Manager jsmanager FancyBox sk_fancybox EG I K Frontend User Management datamints_feuser Direct Mail subscription direct_mail_subscription jQuery FancyBox jg_fancybox Add default CSS fwt_directory ystem toctoc comments Configuration Plugin configuration is explained in User manual This section talks about TypoScript configuration Main configuration Property Data type Description Default code string COMMENTS or FORM or nothing COMMENTS Shows comments listing or and form to submit FORM comments Ratings only display
26. ts tO PAGE c ecccsscccssseeeeceeesee 8 S10 1s eee ee eee ee eee eee ee 20 Use in templavoila cccccccccccccceessssseeeeeceeeeeeeeeeeenenes 8 COORG ONCEPIS a ior ig ee a 20 Customizing COMMENES cccsesssecssessecssessecsesseseeseee 10 Extension architecture ccccccccccsseeeeeeeeeeeeeeeeeees 20 Approving COMMENES ssccsscsssesseesseesseesecseesseeesee 14 AJAX Events ceseeeeeeeseseseseneseneeaeecaesecsseeeseeaseecaenees 20 FAO eat anion ee eect ees 14 ae ea e PCAN CACO oi sissi 15 Using AJAX comments in other extensions 20 Adding TypoScript template re 15 tt_news oneene a a a oats eecesns 20 Configuration ccssssscessssssesssessecssecsesssessecssecsessseeseceeees 15 Hooks PEIE IE P TTE E T E 21 Main COnfiguration cccsccssscsccssessesssecsesssecseseesesseseee 15 SING NOOKS sssrinin aiii 21 Advanced options gt ADVANCED re 17 Common hook parameters edie heap E E E ees 21 Spam protection gt SPAMPROTECT SORE 18 List of hooksS asia cs aco da oa eee 21 Ratings gt RATINGS cccccssssssssessssessesseesteseseeseseees 18 Translating the OXtONSION cscsseseeseesseneerenseeeeenensoes 22 TODO listoissa 22 AJAX commenting system 1 Introduction What does it do This extension provides commenting capabilities to TYPO3 content elements or to virtually any TYPO3 record available in frontend It contains AJAX functionality which works with jQuery 1 7 or newer
27. tzerland Special thanks go to e Dimitry Dupolev and the comments team on forge typo3 org for their important work which is at the base of the code of this extension e Julien Hany the contributor and developer of the used jQuery Extension for Sharing av As of under sharrre com Having questions As the extension is present in its initial version there will be maybe many questions We gave our best for the doc so please first check it seriously before looking for help anywhere else For news checkout www toctoc ch We will provide in future help and support over forge typo3 org Please avoid sending e mails directly user the contact form in www toctoc ch thanks AJAX commenting system 6 Users manual Installing and Setup 1 Install the extension in EM and include it in your sites TS Template Edit Template plugin xxx on page extension_configuration General Options Includes Resources ACCESS Include Static Templates After Basis Templates Include static from extensions Selected Items Available Items 474 Commenting system toctoc_comments Frontend User Management datamints_feuser Direct Mail subscription direct_mail subscription jQuery FancyBox jg_fancybox 15 Manager jsmanager FancyBox sk_fancybox Ea LA e Add default CSS fwt_directory 2 Make sure that JQuery is added to the page by adding something like this to the page config TS page includeJSlibs jJquery
28. ult userContactUC boolean This option enables display of basic user contact 1 information in usercards userHomepageUC boolean This option enables display of the users homepage in 1 usercards userEmailUC boolean This option enables display of the email of the 1 commenting user in usercards userLocationUC boolean This option enables display of the users location in 1 usercards userStatsUC boolean This option enables display of statistics in usercards 1 userlIPUC boolean This option enables display IP information about the 1 user in usercards timeoutUC int Time in seconds for display of a usercard Values 9 between 3 and 15 are ok Options from setup txt preventDuplicatePosts boolean If set prevents duplicate posts on the same page 1 requiredFields list of values Comma separated list of fields to be required for firsthame lastname content email comments Available values firstname lastname email homepage location content requiredFields_errorWrap array dataWrap for required field if field is not filled properly dataWrap lt span class tx toctoc comments required error gt LLL EXT toctoc_comments pi1 locallang xml error amp 32 lt span gt firstName_stdWrap array Wrap for First name field wrap empty lastName_stdWrap array Wrap for Last name field wrap email_stdWrap array Wrap for E mail field wrap webSite_stdWrap array Wrap for Web site field wrap location stdWrap array Wrap
Download Pdf Manuals
Related Search