"Contact Center" is a module for web forms like "Contact us". This module has features following:
Most different point to ordinay form mail module, This module store in database and support and following contact messages.
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}
"Description" use template in "Description type" settings not "Normal[bb]". In "template" types insert form element make variables like {Name} style.
variables Description {FORM_ATTR} form attributes {SUBMIT} Submit button {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] mean display "Description" only Input page, Not display in confirm page. {TO_UNAME}, {TO_NAME} can use in normal description. "Overall template" not use XOOPS themes. Display direct HTML page. "Wide template" settings makes setting smarty variables $xoops_show{c,l,r}block to 0. This function to be work need to depend themes.
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 size of text input maxlength 0 maxlength of text input rows 0 rows number of textarea cols 0 columns number of textarea accept_ext None accept upload file extention in file type input. Example: accept_type=jpg|gif|png|xls
accept_type None accept upload file type in file type input. Example: accept_type=image/jp*g|image/gif|image/png|application/*
Note: accept_type and accept_ext set same number elements (number of part seperate with '|'), check strict both position match.
input_mail_confirm yes/no When setting "no", mail type input without confirm input input_mail_login yes/noconf/no When setting "noconf" with login user, mail type input without confirm input. Setting "no" mail type input not use. When "input_mail_confirm=no" settings, This default work same as "noconf" setting.
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 Move to page URI when after sending form. use_fckeditor None Using FCKeditor for edit description. Setting values Basic or Default from_confirm_tpl form_confirm.tpl Set reply email template filename. charge_notify_tpl None Notification template filename for person in charge. Default use from_confirm_tpl setting. group_notify_tpl なし Notification template filename for groups in charge. Default use from_confirm_tpl setting. other names RegExp Input format checking regular expressions Example: Numeric check numeric=[-+]?[0-9]+, Phone Number tel="\+?[0-9][0-9-,]*[0-9]"
Using in Contact form's "Form defunisions" attribute like check=tel.Regular expressions using JavaScript acceptable range. (Server side use perl regexp, but client side use JavaScript)
Tips for using
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 Contact group.
- Contact Person subscribe notification setting at the message.
- Contact Group member can setting notification each forms.
- Administrator can setting notification for all message.
Note for Security
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
- 2012-01-22 ccenter 0.98
- Fix script insersion vulnerability (thx dramifa)
- Add edit for evaluation value and comment by admin
- Fix message admin list condition lost when paging
- Change logging message format
- Add option variables for email address input (input_mail_confirm, input_main_login)
- Fix some bugs
- 2012-01-14 ccenter 0.97
- Fix directory traversal vulnerability (thx Marijuana)
- Add to check attribute upload file extentin (accept_ext) and mime type(accept_type)
- 2011-10-08 ccenter 0.96
- allow required in "file" type field
- form input value assign to mail variable. (using "{label}" in reply mail)
- 2011-04-24 ccenter 0.95
- Fix can not post comment when guest access
- Fix group in charge access control failer
- Add documentation for email template in option variables
- 2011-03-15 ccenter 0.94
- Fix security vulnerability (thx Hosiryuhosi)
- Fix conflict with altsys language manager
- Fix malfunction rename module folder
- Allow replace reply email tamplate by option variable setting
- 2009-11-15 ccenter 0.93
- Additional message in notification and/or email template for each forms
- Option variables handling reivced
- 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.22 2012/01/22 09:22:18 nobu Exp $