DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
EXT: ECV Subscription Manager¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed by: | Christian Voigt |
Changed: | 2007-10-17T01:24:51 |
Author: | Christian Voigt |
Email: | chris@evolutioncv |
Info 3: | |
Info 4: |
EXT: ECV Subscription Manager¶
Extension Key: my_extension_key
Copyright 2000-2002, Christian Voigt, <chris@evolutioncv>
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¶
EXT: My Extension 1
Introduction 1
What does it do? 1
Screenshots 1
Users manual 1
FAQ 1
Adminstration 1
FAQ 2
Configuration 2
FAQ 2
Reference 2
Tutorial 2
Known problems 2
To-Do list 2
Changelog 2
Introduction¶
What does it do?¶
- Allows you to create simple event-records (titel, time, date, price, location, description, teaser, target-group) and display them in a list or as a detail-page for an specific event. You can also create forms with as many form-fields as you like to subscribe to the events via email. (email function not mplemented as of now.)
- Event-records can be stored in any available page.
- for now you can summarize this extension as follows :-You can create data-records of events, there is a fixed number of fields for this, so it is not very flexible.-You can display your records in a list-view and in a details-page. there is no search function, or filter or anything. all records from the specified page are listet at once.-You can define your form in a template file, all markers are automagicly created, so you can have as many fields as you like- as of now, that is all. there is no function implemented to handle the form data other than displaying it on a relsuts-page. (Which ou could now send via email.)- there is NO error handling, nor is there any kind of field- validation.-
Screenshots¶
This is the Listview.¶
Only a few field are shown, also a link to the details-page and a link to subscribe now!
Details-Page¶
All currently available fields are displayed. There is a link back to the listview and a link to subscribe now!
Form¶
Some fields are shown, to get a summary. Formfields are defined in the template file. there is a link back to the details-page and a submit- button to send the form (not implemented yet)
Backend¶
Just delete and list functions. No search/filter whatsoever
Users manual¶
-Install the extension and update your database
-create a page or pages where you want to diplay you events and insert the ecv-subscription-manager plugin
-copy the subscriptions.html and email.html files from EXT:/pi1/ to your fileadmin folder, or anywhere else within your fileadmin folder.
-insert some typoscript to configure the extension, for now it is just the directory of the template.and the folder where to look for records. (if this is not set, the current page where the plugin is included will be used)
plugin.tx_ecvsubscrmgr_pi1 {
mainConfig.pageID = 71
mainConfig.Template = fileadmin/templates/ecv_subscrmgr/subscriptions.html
mainConfig.emailTemplate = fileadmin/templates/ecv_subscrmgr/email.html
}
- create some records by switching to listview and to the page you specified with typoscript or the page where the plugin is included and add a new record. fill out the fields and save. repeat as often as required.
- you can now view your page.
- you may want to alter the two template files according to your wishes.
- formfields are identified by their name attribute, the plugin will create a marker for each form-field, this is devised from the name attribute. All markers are all upper-case (if you form field has the name-attribute “name” a marker named ###NAME### will be created for use in your email.html template)
- all subscriptions are stored in the database, they are accesible with the backend module Web/ECV-Subscriptions)
FAQ¶
- No records are displayed : you may have set a wrong pageID. If you stored your records on the same page as the plugin then simply leave this one out. It will find them automaticly if parameter pageID is not set
- Nothing gets displayed, although I am sure I have the right path (see uestion above): you may want to check your access rights for your template files in fileadmin (or wherever you have put them). For testing purposes you can set them to read/write (Win) or 777 (Unix/Linux)
Configuration¶
FAQ¶
Reference¶
- Possible subsections: Reference (TypoScript)
pageID¶
Property
pageID
Data type
int
Description
Sets the page the plugin looks for records. If this is not set the page where the plugin is included will be used.
Default
Template¶
Property
Template
Data type
string
Description
path to the template file. Should be somewhere in your fileadmin folder.
Default
emailTemplate¶
Property
emailTemplate
Data type
string
Description
path to the email-template file. Should be somewhere in your fileadmin folder. This could be used to create confirmation emails
Default
Tutorial¶
see User Manual for now...
Known problems¶
- there are no implemented email functions for now. This extension in its actual state is pretty useless for non-programmers.
- No form-validation is implemented. In fact, there is virtually no Error-Handling at all!
Changelog¶
- 0.0.1 – 10.Okt.2007+ (Initial release)
- 0.0.2 – 11.Okt.2007+ Implemented email-template. The created output can be used to send by mail or to store it elsewhere.+ Implemented auto-markers. Whatever form fields you specify in your template, markers will be cretat for use in your email-template+ updated template-files, there is a much better representation of what is possible and how its doneo Manual updated
- 0.0.3 – 16.Okt.2007+ Introduced Backend-Module+ some new Markers for template+ Supscriptions are now stored in the database for future reference and editingo manual updated
- 0.0.4 – 17.Okt.2007+ rewrite of template handling+ lgenerated links are now typo3-coding-guidlines+ added backend module functions : list of subscriptions, delete function, info-function
EXT: ECV Subscription Manager - 5