Contact Center module


Abstruct of Contact Center module

"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.

Formular Definitionen
Ein neues Formular erstellt/ändert man in der Administration über das obere Menü "Forms". Die Formumar Definitionen befolgen folgende Syntax:
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}

Beispiele:
DefinitonRepräsentiertBeschreibung
Name*Name* Das "*" macht die Eingabe dieses Feldes erfordelich. Typ wird autmatisch auf "text" gesetzt.
Name*,size=5Name* Hier wird das Attribut verwenden um die Länge zu bestimmen
Name*,size=10,Default,#BeschreibungName* BeschreibungDas Argument "#" als Prefix bedeutet dass "Beschreibung" als Text angezeigt wird.
Name,size=10,check=reqire,{X_NAME},#CommentName Commentchecking requirement like this. Default value {X_NAME} are expand user information.
Selection,radio,Item1+,Item2<br/>,*=othersSelection Item1   Item2
others
Include HTML tags in label, but ignore in value. The value use "*", that use text input.
Selection,checkbox,Item1+,Item2,Item3Selection Item1   Item2   Item3 "+" bedeutet dass das Item1 per default als ausgewählt angezeigt wird.
Selection,select,Item1,Item2,Item3Selection
Label,const,valueLabel valueShow the value as is and that input value.
Label,hidden,value(Im Formular nicht angezeigt)This is handle input value.
#Kommentar/BeschreibungKommentar/Beschreibung
Custom Form

"Beschreibung" use template in "Beschreibungstype" settings not "Normal[bb]". In "template" types insert form element make variables like {Name} style.

variablesDescription
{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
Preferences

Module preferences has following items.

Item NameSetting/DefaultDescription
Number of list items25Set number of list show a display
Default Attributessize=60, rows=5, cols=50, notify_with_email=0Setting form definition and other attribute default value.
Status selections
All: - a b c
Open: - a
Closed: b c
--------:
Waiting: -
Working: a
Replyed: b
Done: c
the 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 NameSetting/DefaultDescription
size0Länge des Eingabefeldes
maxlength0Maximale Länge der Eingabe
rows0Anzahl der Zeilen in einem Textfeld
cols0Anzahl der Spalten in einem Textfeld
notify_with_email0When setting 1 email address include in notification
export_charsetUTF-8force setting encoding for CSV format file output.
redirectURIGehe zur URL nach dem Absenden des Formulares.
other namesRegExpInput 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.

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=YY

This 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 $