Please read the 'Configuration' chapter to get a proper installation of the extension before using the backend configuration possibilities described in this chapter.
IMPORTANT! Reorganisation of the TypoScript template structure sinve v0.4.3: Due to a reorganisation of TypoScript template config:in version 0.4.3 the extension's TS template will not be added automatically to all pages anymore, rather the user has to include the static extension template 'Conference basic configuration' where needed. So don't forget to add the extension's static template manually if you update a former version of the extension!
IMPORTANT! 'Import static data' feature of extension manager: Be careful with this feature of extension manager - once you have adjusted your database tables (see above) or changed some database tables (e.g. products) an re-import of static data will override all your changes and set up the default tables again (as the static data file requires the deletion of any mentioned tables)!
Basic TypoScript setup: If you need a quick setup to check the extension, in the 'doc' directory of this extension you'll find basic TypoScript example for copy&paste to your template (EXT:pt_conference/doc/setup_basic.ts ). This setup example is pre-configured to use the basic example design template provided at EXT:pt_conference/res/setup_basic_tmpl.html.
Integration of style sheets: In the current version the styles sheets are handled by CSS file in the 'res' directory of the extension (EXT:pt_conference/res/pt_conference.css). If you want to integrate these extension styles for your conference page you have to add this line of TypoScript to the setup of your root template:
page.stylesheet = typo3conf/ext/pt_conference/res/pt_conference.css
Edit this file to change the HTML styles (will be changed in future, see To-Do list) or use your own one stylesheet file at an arbitrary position (in this case don't forget to set the extensions style classes in your own file).
PDF generator error: If no PDF file is available for an invoice, cancellation or credit note (the site admin configured in Constant Editor gets an automatic email on PDF generation errors), you should check if pt_html2pdf works correctly and check write access of the PDF ouptput file defined in the Constant Editor (see list below).
A lot of settings of this extension can be configured in TYPO3's Constant Editor: You'll find several categories/pages for pt_conference extension at the Constant Editor's category selectorbox. Please check all settings before you use the extension, because many of them are required features (some components will not work if these are not configured).
Category: PT_CONFERENCE: GENERAL (27)
Enable features | |
Conference name | [plugin.tx_ptconference.conferenceName] |
Name of the conference your setting up the website for. This name will be used for different purposes, e.g. as subject prefix of automatic emails. Default: | |
Conference abbreviation/prefix | [plugin.tx_ptconference.conferencePrefix] |
Abbreviation of the conference name. This is used as a prefix for customer numbers generated by this conference extension and for uploaded conference paper files. Default: con | |
URL of the conference website | [plugin.tx_ptconference.conferenceUrl] |
Complete URL of the conference website where this extension is running on, including "http://" or "https://". Default: | |
Currency code | [plugin.tx_ptconference.currencyCode] |
The ISO three letter currency code specifying the currency that is used (e.g. EUR for Euro, USD for US Dollar). This is used for ordering, accounting and invoices. If you're not sure about the correct code use phpMyAdmin and have a look to the 'static_currencies' database table (part of the 'static_info_tables' extension). Make sure to use the same currency code in your ePayment extension if you use this one, too. Default: EUR | |
FE users sysfolder PID | [plugin.tx_ptconference.feusersSysfolderPid] |
TYPO3 PID (Page ID, no alias here!) of your FE users sysfolder.Range: 0 - Default: | |
MD5 security check "salt" | [plugin.tx_ptconference.md5SecurityCheckSalt] |
"Salt" string to use for building an md5 hash used for security checks within this extension (e.g. for checking successful payment returns from ePayment extensions). IMPORTANT: Change the default setting for security reasons! Default: ThisIsTheDefaultPtConferenceSalt | |
Email recipient for system mails | [plugin.tx_ptconference.systemMailRecipient] |
Email recipient address (comma-seperated list for multiple recipients) for auto-generated system emails of the conference extension (e.g. VAT check, ePayment verification warning). Default: | |
Email recipient for customer mails | [plugin.tx_ptconference.customerMailRecipient] |
Email recipient address (comma-seperated list for multiple recipients) for customer request emails (e.g. questions regarding invoices). Default: | |
Email domain for system mails | [plugin.tx_ptconference.systemMailSenderDomain] |
Domain part for auto-generated system emails of the conference extension (e.g. VAT check, ePayment verification warning), usually the domain name of the conference website (e.g. myconference.com). Default: | |
Early Bird end date | [plugin.tx_ptconference.earlybirdEnddate] |
End date [yyyy-mm-dd] for all early bird discounts (given date is the last day included in the discount period). Default: | |
VAT rate | [plugin.tx_ptconference.vatRate] |
VAT rate for all products offered in this conference extension. Default: 19 | |
Credit card provision percentage | [plugin.tx_ptconference.ccProvision] |
Provision percentage the organizer has to pay to the credit card payment service provider. Used for net sum statistics of ther statistics module [relates to "Statistics Area" plugin: pi3]. (This setting has no effect if credit card payment is disabled in config.) Default: 2.8 | |
Enable tutorials | [plugin.tx_ptconference.enableTutorials] |
Flag whether tutorials should be offered for the conference [relates to "Speakers area" and "Visitors Area" plugins: pi4, pi1]. Default: 1 | |
Invoice - Counter start no. | [plugin.tx_ptconference.billNoStartCounter] |
Starting number for Invoice No. counter (bill no has 5 digits: e.g. billNoStartCounter = 1 results in starting no. 00001) Default: 0 | |
Invoice - Standard prefix | [plugin.tx_ptconference.billNoPrefixStandard] |
Invoice No. prefix for standard invoices Default: INV- | |
Invoice - Credit note prefix | [plugin.tx_ptconference.billNoPrefixCredit] |
Invoice No. prefix for credit notes Default: CRE- | |
Invoice - Cancellation prefix | [plugin.tx_ptconference.billNoPrefixCancellation] |
Invoice No. prefix for cancellation invoices Default: CAN- | |
Invoice - Days to pay | [plugin.tx_ptconference.billDaysToPay] |
Number of days to pay invoice (due date = invoice date + this value) Default: 5 | |
Invoice - No. of items | [plugin.tx_ptconference.billItemsPerPage] |
Max. number of items for one invoice Range: 0 - Default: 12 | |
Files | |
PDF ouptput directory | [plugin.tx_ptconference.billDir] |
Directory for generated bill files output in PDF format. Default: fileadmin/pdf | |
Template for accounting display | [plugin.tx_ptconference.templateFile] |
HTML-template file used for different accounting-related displays of the conference extension.(html,htm,tmpl,txt) Default: EXT:pt_conference/res/accounting.tmpl | |
Template for bills | [plugin.tx_ptconference.billTemplate] |
HTML-template file used for PDF generation of bills Default: EXT:pt_conference/res/bill.html | |
Typography | |
Wrap 1 | [plugin.tx_ptconference.feuser_wrap1] |
This wrap is used in the template-file of the FE user registration (speaker/visitors/...). Default: <font face="verdana" size=2 color=black> | </font> | |
Wrap 2 | [plugin.tx_ptconference.feuser_wrap2] |
This wrap is used in the template-file of the FE user registration (speaker/visitors/...). Default: <font face="verdana" size=1 color=black> | </font> | |
Colors | |
Color 1 | [plugin.tx_ptconference.feuser_color1] |
This bgcolor is used in the template-file of the FE user registration (speaker/visitors/...). Default: #cccccc | |
Color 2 | [plugin.tx_ptconference.feuser_color2] |
This bgcolor is used in the template-file of the FE user registration (speaker/visitors/...). Default: #999999 | |
Color 3 | [plugin.tx_ptconference.feuser_color3] |
This bgcolor is used in the template-file of the FE user registration (speaker/visitors/...). Default: #333333 |
Category: PT_CONFERENCE: ORGANIZER DATA (19)
Enable features | |
Organizer - VAT ID | [plugin.tx_ptconference.vatId] |
VAT ID of the conference organizer (used for invoices). Default: | |
Organizer - Tax ID | [plugin.tx_ptconference.taxId] |
Tax ID of the conference organizer (used for invoices). Default: | |
Organizer - Bank name | [plugin.tx_ptconference.bankName] |
Name of the organizers' bank institute (used for bank transfer). Default: | |
Organizer - Bank ID (national) | [plugin.tx_ptconference.bankId] |
National bank sorting code of the organizers' bank institute (used for national bank transfer). Default: | |
Organizer - Bank account (national) | [plugin.tx_ptconference.bankAccount] |
National account number of the organizers' bank account (used for national bank transfer). Default: | |
Organizer - Bank account holder | [plugin.tx_ptconference.bankAccountHolder] |
Name of the holder of the bank account (used for bank transfer). Default: | |
Organizer - Bank BIC | [plugin.tx_ptconference.bankBic] |
Bank Identification Code (SWIFT) of the organizers' bank institute (used for international bank transfer). Default: | |
Organizer - Bank IBAN | [plugin.tx_ptconference.bankIban] |
International Bank Account Number of the organizers' bank account (used for international bank transfer). Default: | |
Organizer - Company name | [plugin.tx_ptconference.organizerName] |
Name of the organizing company (used for invoices) Default: | |
Organizer - Address | [plugin.tx_ptconference.organizerAddress] |
Address of the organizing company (used for invoices) Default: | |
Organizer - Zip | [plugin.tx_ptconference.organizerZip] |
Zip code of the organizing company (used for invoices) Default: | |
Organizer - Town | [plugin.tx_ptconference.organizerTown] |
Town of the organizing company (used for invoices) Default: | |
Organizer - Country | [plugin.tx_ptconference.organizerCountry] |
Country of the organizing company (used for invoices) Default: | |
Organizer - Phone | [plugin.tx_ptconference.organizerPhone] |
Phone number of the organizing company (used for invoices) Default: | |
Organizer - Fax | [plugin.tx_ptconference.organizerFax] |
Fax number of the organizing company (used for invoices) Default: | |
Organizer - WWW | [plugin.tx_ptconference.organizerWWW] |
URL of the organizing company (used for invoices) Default: | |
Organizer - Email | [plugin.tx_ptconference.organizerEmail] |
Email address of the organizing company (used for invoices) Default: | |
Organizer - CEO | [plugin.tx_ptconference.organizerCEO] |
CEO of the organizer (used for invoices) Default: | |
Organizer - Incorporation | [plugin.tx_ptconference.organizerIncorporation] |
Incorporation of the organizing company (used for invoices) Default: |
Category: PT_CONFERENCE_PI1: VISITORS AREA (13)
Enable features | |
Enable credit card payment | [plugin.tx_ptconference.enableCcPayment] |
If DISABLED (set to 0), no credit card payment option will be offered at the registration (bank transfer will be set by default at the registration's billing information form). If set to 1, CARDIA EPAYMENT (see http://www.cardia.no/View/Cardia_EN/index.html) will be used for credit card payment - IMPORTANT: this requires the latest version of extension pt_payment to be installed (plugin pi1 installed on credit card payment page)!. If set to 2, HEIDELPAY EPAYMENT (see http://www.heidelpay.de/) will be used for credit card payment - IMPORTANT: this requires PHP5 and the latest version of extension pt_heidelpay to be installed (plugins XML/pi1 OR WPF/pi3 installed on credit card payment page). (0) Disable CC payment(1) Use Cardia ePayment(2) Use Heidelpay ePayment Default: 1 | |
Max. number of attendees | [plugin.tx_ptconference.maxConferenceAttendees] |
The maximum number of attendees allowed for the conference. If the number of registered attendees exceed this amount, the conference registration will close automatically with a "Fully booked" notice. Set '-1' here if you don't want any attendee limitation (this is the default), set '0' here to stop further registration immediately (don't forget to clear all cache!). (Integer) Default: -1 | |
Additional attendees per order | [plugin.tx_ptconference.addAttendeesPerOrder] |
Max. number of additional attendees to register within one order. Default: 4 | |
Extra social events per attendee | [plugin.tx_ptconference.maxEvents] |
Max. number of extra social events to be ordered per attendee. Default: 5 | |
Credit Card ePayment page | [plugin.tx_ptconference.paymentPage] |
Identifier (PID or alias) of the TYPO3 page where you've integrated the credit card ePayment Plugin (Extensions pt_payment or pt_heidelpay, see config option "enableCcPayment" below) to enable payments through credit card. This page should have the "not in menu" type to hide from enduser navigation. [This setting is not required if the config option "enableCcPayment" (see below) is set to 0 (disable)!] Default: payment | |
Conference registration page | [plugin.tx_ptconference.registrationPage] |
Identifier (PID or alias) of the TYPO3 page where you've integrated the "Conference Visitors Area" Plugin (pi1 of this extension) with the type "Conference Registration". Default: confreg | |
Browser navigation notice page | [plugin.tx_ptconference.browserbackPage] |
Identifier (PID or alias) of the TYPO3 page where you hold a notice for users who used the browser's back button after finishing their order. This is used for redirection of the user if he tried this. The notice page should have the "not in menu" type to hide from end user navigation. Default: browserback | |
Contact page | [plugin.tx_ptconference.contactPage] |
Identifier (PID or alias) of the TYPO3 page where you've integrated your contact form or contact information for users. This will be linked at many points, e.g. if problems occur. Default: contact | |
Accounting status PID | [plugin.tx_ptconference.accstatPid] |
TYPO3 PID (Page ID, no alias here!) of the page where you've integrated the "Conference Visitors Area" plugin of this extension with the chosen type "Accounting Status". This is used for redirection of the user after finishing an order. Range: 0 - Default: | |
Others | |
Enable free tee-shirt addition | [plugin.tx_ptconference.enableFreeTshirtAddition] |
If unchecked, no free tee-shirt will be added to each admission order. Default: 1 | |
Enable extra social event booking | [plugin.tx_ptconference.enableExtraSocialEventBooking] |
If unchecked, no extra social event booking will be offered at the registration. Default: 1 | |
Enable multiple attendee booking | [plugin.tx_ptconference.enableMultipleAttendeeBooking] |
If unchecked, no booking of additional attendees will be offered at the registration. Default: 1 | |
Use VAT ID | [plugin.tx_ptconference.useVatId] |
If unchecked, no input field for a VAT ID will be offered at the registration's billing information form and all resulting VAT ID related actions will be disabled. Default: 1 |
Category: PT_CONFERENCE_PI4: SPEAKERS AREA (18)
Enable features | |
New paper abstract submission end | [plugin.tx_ptconference.newPaperSubmissionEnddate] |
End date [yyyy-mm-dd] for the submission of new paper abstracts (given date is the last day included in the paper submission period). Default: | |
Paper Rating Ignore UID | [plugin.tx_ptconference.paperRatingsIgnoreUid] |
UID of the paper ratings record (in DB table "tx_ptconference_ratingvalues") to ignore for counting of total rating quantity in the admin's view of "committee overview". Default = the UID of the default rating record "(not stated yet)". Default: 4 | |
Use target audience | [plugin.tx_ptconference.usePaperTargetAudience] |
Flag whether the selection of target audiences should be offered at paper submission. Default: 1 | |
Use target OS | [plugin.tx_ptconference.usePaperTargetOS] |
Flag whether the selection of target OS should be offered at paper submission. Default: 1 | |
Use double time presentations | [plugin.tx_ptconference.usePaperOption1] |
Flag whether the option of double time presentations should be offered at paper submission. Default: 1 | |
Use proceedings permission | [plugin.tx_ptconference.usePaperPerm1] |
Flag whether the "Permission to publish the paper in conference proceedings" should be offered at paper submission. Default: 1 | |
Use website permission | [plugin.tx_ptconference.usePaperPerm2] |
Flag whether the "Permission to publish the paper on this website after the conference" should be offered at paper submission. Default: 1 | |
Files | |
FE-User upload parent directory | [plugin.tx_ptconference.uploadParentDir] |
Parent directory for alle FE user uploads subdirectories (don't forget the ending slash '/'!). Make sure this directory exists and it's writeable for the web server! Within this parent directory each speaker gets a individual subdirectory named like his login name to upload his potrait image file and his paper(s) as a PDF file. ["Speakers area" plugin] Default: fileadmin/fe_user/ | |
Image upload - max. file size | [plugin.tx_ptconference.uploadMaxSizeImg] |
Maximum size (byte) of images to upload for author's description. Notice: This value is still limited by your PHP setting for maximum-size. ["Speakers area" plugin] Default: 50000 | |
Image upload, allowed mime types | [plugin.tx_ptconference.uploadAllowMimeImg] |
Comma separated list of mime types allowed for the image file upload. Notice: a blank field allows all mime types. ["Speakers area" plugin] Default: image/gif,image/jpeg,image/png,image/pjpeg,image/x-png | |
Image upload, allowed file name ext... | [plugin.tx_ptconference.uploadAllowExtImg] |
Comma separated list of file name extensions (without leading dot '.') allowed for the image file upload. Notice: a blank field allows all extensions. ["Speakers area" plugin] Default: gif,jpg,jpeg,png | |
Image upload, max. scaling width | [plugin.tx_ptconference.uploadScaledImgMaxWidth] |
Max. width (pixel) for the uploaded image's scaled duplicate (used for web display). ["Speakers area" plugin] Default: 120 | |
Image upload, max. scaling height | [plugin.tx_ptconference.uploadScaledImgMaxHeight] |
Max. height (pixel) for the uploaded image's scaled duplicate (used for web display). ["Speakers area" plugin] Default: 200 | |
Paper upload, max. file size | [plugin.tx_ptconference.uploadMaxSizePaper] |
Maximum size (byte) of PDF papers to upload for author's description. Notice: This value is still limited by your PHP setting for maximum-size. ["Speakers area" plugin] Default: 500000 | |
Paper upload, allowed mime types | [plugin.tx_ptconference.uploadAllowMimePaper] |
Comma separated list of mime types allowed for the paper file upload. Notice: a blank field allows all mime types. ["Speakers area" plugin] Default: application/pdf | |
Paper upload, allowed file name ext... | [plugin.tx_ptconference.uploadAllowExtPaper] |
Comma separated list of file name extensions (without leading dot '.') allowed for the paper file upload. Notice: a blank field allows all extensions. ["Speakers area" plugin] Default: pdf | |
Content: 'List of records' | |
Results per page | [plugin.tx_ptconference.listView.results_at_a_time] |
Number of results to be shown on one page of the list view. ["Speakers area" plugin] Range: 1 – 100 Default: 10 | |
Max. page links | [plugin.tx_ptconference.listView.maxPages] |
Max. number of 'Page 1 - Page 2 - ...'-Links in the list view result browser. ["Speakers area" plugin] Default: 5 |
Database records can be displayed using the 'Web'->'List' module of the TYPO3 backend for the appropriate page. Generally a blue record symbol means for the conference extension items that (parts of) the respective records may be changed (see e.g. 'Edit static data at site root' for details). A red symbol means that these records are not intended to be edited in the backend (generated records from frontend interfaces, e.g. see 'Overview of registration/billing records' for details).
Edit static data at site root
If you choose 'Web'->'List' for the site root (globe symbol on top of the page tree) you'll get an overview of static data items used by the extension (database tables imported via 'Import static data' in the extension manager). You can add and modify items here, but be sure that you know what you're doing.
Some of the relation to these items are hardcoded in the extensions' code, so depending on what you're going to change you'll have to adjust the source code, too.
Without worries you can do the following:
add/edit/delete 'target operating systems' (this is displayed as a selectorbox at paper submission form for registered speakers)
add/edit/delete 'target audiences' (this is displayed as a selectorbox at paper submission form for registered speakers)
change product prices by editing the existing products records (these prices are used for within the ordering process and for accounting). IMPORTANT: After opening the visitor registration (“Conference visitors area/Conference Registration” plugin) the assigned product prices must not be changed anymore, as they are internally used for the product order relations!
add/edit/delete 't-shirt sizes' (this is displayed as a selectorbox at “Attendee status” form for registered attendees)
add/edit/delete 'session tracks' (this is displayed as a selectorbox at a paper's BE form view)
edit the texts of the 'paper rating values' (this is displayed as a selectorbox at “Attendee status” form for registered attendees)
change the sorting order of the above mentioned records (this changes the order of display, e.g. in selectorboxes)
WARNING: Don't delete records and don't change UIDs of 'products', 'visitor status' and 'fe_groups' at this state of the extension! (Hint for developers: there are some more 'visitor status' records with the deleted flag set in the related database table tx_ptconference_visitorstatus. You may change the deleted flag to 0 and use these in your implementation).
IMPORTANT: Don't use the 'Import static data' feature of extension manager after changing static data: once you have adjusted or changed your database tables (see above) an re-import of static data will override all your changes and set up the default tables again (as the static data file requires the deletion of any mentioned tables)!
Edit papers (respective talks and tutorials)
To display/edit submitted papers in the BE choose 'Web'->'List' for the page where you've included “Conference speakers area/Paper Registration” (see “User's manual/Handling of Speakers, Papers, Talks and Tutorials”). IMPORTANT: After opening the visitor registration (“Conference visitors area/Conference Registration” plugin) the assigned “accepted-as-tutorial”-numbers and paper acceptance flags must not be changed anymore, as they are internally used for the product order relations and talks wishlist relations.
Edit frontend users
To edit FE user records, choose 'Web'->'List' for your “FE Users” sysfolder. Here you may view edit user records and annote some general comments for an user.
Overview of registration/billing records
If you want to get a BE overview of all database records created by your registration/order page (e.g. invoice records), choose 'Web'->'List' for the page where you've included “Conference visitors area/Conference Registration”. It is highly recommend not to change any records here, as this may cause serious problems.
