"Contact Center" ist ein Formular-Modul wie z.B. für ein Kontaktformular. Dieses Modul hat folgende Funktionalitäten:
Der grösste Unterschied zu einem gewöhnlichen Formular-Modul: Dieses Modul speichert die abgesendeten Daten in der Datenbank und unterstützt das Auswerten der Daten.
line ::= label["*"][,type][,attribute...][,argument...] type ::= {text|checkbox|radio|textarea|select|const|hidden|mail|multi|file}
argument ::= [value ["+"] "="] display-value
attribute ::= aname "=" value
aname ::= {size|rows|maxlength|cols|prop|check}
"Beschreibung" use template in "Beschreibungstype" settings not "Normal[bb]". In "template" types insert form element make variables like {Name} style.
variables Description {FORM_ATTR} form attributes {SUBMIT} Absenden Schaltfläche {BACK} Re-Edit button {CHECK_SCRIPT} Checking JavaScript {Name} Input field element of Name {TO_UNAME} {TO_NAME} Member of group settings, uid setting user's uname and name
- Need every variable represent once.
- Edit contact form page's "Adding template" button makes set of variables adding in description.
- Basicaly custom template form following variable sets (The element will be arrangement in a form tag)
<form {FORM_ATTR}> Item1: {Item1} Item2*: {Item2} : Item-n: {Item-n} {SUBMIT} {BACK} </form> {CHECK_SCRIPT}[desc]Description[/desc] bedeutet dass die "Description" auf der Eingabeseite angezeigt wird und nicht auf der Bestätigungsseite. {TO_UNAME}, {TO_NAME} can use in normal description. "Overall template" bedeutet dass man nicht die Impresscms Templtes nutzen will. Es wird direkt als HTML Seite angezeigt. "Wide template" Ob diese Einstllung funktioniert hängt von dem Theme ab. Es seetzt die smarty Variablen $xoops_show{c,l,r}block auf 0.
Module preferences has following items.
Item Name Setting/Default Description Number of list items 25 Set number of list show a display Default Attributes size=60, rows=5, cols=50, notify_with_email=0 Setting form definition and other attribute default value. Status selections All: - a b c Open: - a Closed: b c --------: Waiting: - Working: a Replyed: b Done: cthe Format as: Display-label: [status1[,status2...]], include multipule lines. the status is a character from (-,a,b,c). Each character mean as -:waiting, a:working, b:reply and c:close.
Option variables
Attribute Name Setting/Default Description size 0 Länge des Eingabefeldes maxlength 0 Maximale Länge der Eingabe rows 0 Anzahl der Zeilen in einem Textfeld cols 0 Anzahl der Spalten in einem Textfeld notify_with_email 0 When setting 1 email address include in notification export_charset UTF-8 force setting encoding for CSV format file output. redirect URI Gehe zur URL nach dem Absenden des Formulares. other names RegExp Input format checking regular expressions Beispiel: Ziffernüberprüfung numeric=[-+]?[0-9]+;, Telefonnummer tel="\+?[0-9][0-9-,]*[0-9]"
In Formularen die Attribute wie folg benutzen check=tel.Regular expressions using JavaScript acceptable range. (Server side use perl regexp, but client side use JavaScript)
Tips zur Benutzung
Notification
Notification using XOOPS notification system. Except for contact person/group setting. Contact person/group notification occurrence any time.
- Event notification method is use user settings.
- Contact Person setting 'None', notification to Kontaktgruppe.
- Contact Person subscribe notification setting at the message.
- Kontaktgruppe member can setting notification each forms.
- Administrator can setting notification for all message.
Wichtig für die Sicherheit
In this module using XOOPS comment system. When you use Comment custamization (modules/blocks/plugins/hacks...) to display, need to carefully. Comments in this module, include private information.
For example, Using "System" module's "Recent Comments" block, there is display comment title in this module. In this case, can not read message body, but some other information will be leak.
Otherwise, Like "Whatsnew" module using, comment body display.
"Contact person" setting member of group
"Contact person" setting "Member[group]" mean choose a person when form sending, using HTTP argument "uid=YY" (YY is userid that member of group).
XOOPS_URL/modules/ccenter/index.php?form=XX&uid=YYThis setting to use assume link from other pages. Can not use stand alone in this module.
Typical use, In case "Some page that contact to auther" form. Modify template other module, for adding the link to form.
Changes
- 2009-07-04 ccenter 0.92
- add search function in message admin page
- keep option value when edit form blocks (thx jun)
- add german language resouces (thx Rene)
- Make not a link at last item in breadcrumbs
- Assign breadcrumbs when custom form
- Fix form template typo (thx L2)
- 2009-06-12 ccenter 0.91
- Display use definitions in radio, select, checkbox widgets
- Fix overall template not worked
- Fix form's managemnt link mistake
- Fix widget template for attachment file (thx yata)
- Fix email store length expand to 256 chars (thx shige-p)
- 2009-06-06 ccenter 0.90
- Fix XOOPS 2.3 compatibility
- Add option variables on each forms
- Fix mail address store in body
- Make form widgets use template
- Fix mistake display posted datetime (thx zorro87)
- Fix onetime password mistake authentication (thx zorro87)
- Fix form block submit url (thx uhouho)
- Add language resources "portuguese" (thx leco1)
- 2009-03-15 ccenter 0.89
- Parse "Attributes" make to robust in preferences
- Fix event notifications when send form (thx yue178)
- Fix required textarea problem
- Fix mail template message
- Apply 'const/hidden' user variable
- Fix show message page template
- 2008-06-15 ccenter 0.88
- show access mark in message listing
- fix dispaly access time mistake
- contactee access time update every time
- revice JavaScript regexp match escape
- remove HTML tags in CSV labels
- CSV output encoding set by attribute in preferences (export_charset=UTF-8)
- fix notify_with_email=1 saved extra email address
- fix textarea check require error when newline include
- 2008-06-01 ccenter 0.87
- Template mode show with comment
- Attribute name using checking regular expressions
- Form defunitions accept CSV quotation
- Blocks form using select button
- Admin preview reviced
- Fix when no saveing redirection page
- Add contactee access time in database (Following read contactee)
- 2008-05-17 ccenter 0.86
- add "Never store" mode for "Store in Database"
- Create sample form when new install
- Add "Default Form attributes", notify_with_email=1 setting show email address in notify email
- Form item name start "-", show that same line with previus item
- 2008-02-29 ccenter 0.85
- Add form item input helper
- Add comment notification event when do evaluation
- Fix present status logging when evaluation
- Fix last year range mistake when CSV output
- 2008-01-31 ccenter 0.84
- Add language english
- Extent alternate label to Item name
- Add a item type "const"
- Add form block
- Fix bug handling quote(')
- Fix require checking in JavaScript on IE
- 2007-11-01 ccenter 0.83
- add CSV output limit range
- Fix member of group to work
- Logging and notification when evaluation
- 2007-10-27 ccenter 0.82
- add notification variable {REMOTE_ADDR}, {HTTP_USER_AGENT}
- add "Wide template" mode
- Fix guset comment and logging failer
- add item initialize variable ({X_UNAME}=username etc)
- Fix admin status bulk change failer
- Fix admin status change reporting error
- 2007-08-06 ccenter 0.81
- Rivised breadcrumbs
- Fix blocks declear global for XCL 2.1
- 2007-08-03 ccenter 0.8
- Add status change notification
- Add message admin page
- Revised contact person selecting
- Using functionaly list
- Add block conditions
- Revised page title
- separate Sending/Contact page and enhancement
- Fix can not access when no messages
- Add logging table
- Using altsys when exists
- 2007-06-14 ccenter 0.71
- Allow form item use default value
- Fix comment reply notify to guest
- Fix multibyte filename handling
- Fix hilien and mail item conflict failer
- Fix radio item using others default checked
- 2007-05-13 ccenter 0.7
- Add contact person set group
- Change CSV output encode SJIS to UTF-8
- Fix can use DELETE status
- Add others with text with checkbox/radio items
- Checking attribute extention (check=xx)
- Add hilien type
- fix comment display
- 2007-03-07 ccenter 0.6
Nobuhiro YASUTOMI <nobuhiro.yasutomi@nifty.ne.jp> MySite Users http://myht.org/
$Id: help.html,v 1.2 2009/07/04 05:39:23 nobu Exp $