內容簡介
WP Tournament Registration 是一個外掛，提供為業餘體育賽事報名參賽者的短碼。事實上，它是為了我所屬的本地象棋俱樂部錦標賽而製作的。它提供了四個不同的短碼以呈現不同的資訊：
[wptournregedit tournament_id="myID" /] 為參賽者資料的編輯工具。
[wptournregexport tournament_id="myID"]...[/wptournregexport] 是一個純文字匯出過濾器。
[wptournregform tournament_id="myID"]...[/wptournregform] 是人們可以透過它來報名參賽的表單。它包含一些 [wptournregfield field="fieldname" /] 短碼，可自訂所需的輸入項目。
[wptournreglist tournament_id="myID" /] 是一個可排序的列表，顯示所有已經核准的參賽者。
所有這些短碼都可以透過一組可選屬性進行自訂。
可用的欄位
address [文本]: 自我解釋。
affiliation [文本]: 俱樂部或協會。
approved [複選框]: 只有當核准選項被勾選時，報名者的項目才會顯示在列表或透過匯出過濾器中。
birthyear [整數]: 自我解釋。
city [文本]: 自我解釋。
custom1, custom2, custom3, custom4, custom5 [文本]: 如果有任何内容缺失，可使用自訂欄位。
email [文本]: 自我解釋。
fee_is_paid [複選框]: 自我解釋。
firstname [文本]: 自我解釋。
id [唯獨]: 一個整數，作為主鍵使用，每次註冊時都會增加。如果同一人註冊兩次，可使用此欄位來區分項目。
ip [唯獨]: 透過 wptournregform 提交者的遠端 IP。對於安全檢查可能會有用。
lastname [文本]: 自我解釋。
message [文本框]: 自我解釋。
phone1 [文本]: 自我解釋。
phone2 [文本]: 自我解釋。
postcode [整數]: 自我解釋。
protected [複選框]: 如果勾選，參賽者的所有聯繫資訊都會在列表視圖中被隱藏。
rating1 [整數]: 用於計算排名列表的等級分數。
rating2 [整數]: 用於計算排名列表的等級分數。
time [唯獨]: 一個時間戳記，記錄提交的確切日期和時間。
請勿濫用欄位，因為會對值進行一些內部檢查。請使用自訂欄位。字符輸入欄位的長度很難確定，因為這取決於它的用途。但對於其目的而言，它們都是合理長度。
屬性
wptournregedit:
tournament_id （必填項）。
display_fields 一個逗號分隔的欄位名稱列表，以檢視的順序排列。
wptournregexport:
tournament_id（必填項）。
all 如果設定為任何值，列表將顯示所有項目，否則僅顯示已勾選“核准”標記的項目。
class 在表單中添加一個以空格分隔的自訂 CSS 類列表。
css 在表單中添加自訂 CSS 的樣式屬性。
id 在表單中添加一個自訂的 CSS ID。
display_fields 一個以逗號分隔的欄位名稱清單，按照顯示的順序排列。
外掛標籤
開發者團隊
原文外掛簡介
WP Tournament Registration is a plugin that provides shortcodes intended for registering players with hobby sport events. As a matter of fact, it was made for the championship of my local chess club. There are four shortcodes for different views:
[wptournregedit tournament_id="myID" /] is an editor for the players’ data.
[wptournregexport tournament_id="myID"]...[/wptournregexport] is a plain text export filter
[wptournregform tournament_id="myID"]...[/wptournregform] is a form where people can register with the competition. It covers some [wptournregfield field="fieldname" /] shortcodes which customize the desired inputs.
[wptournreglist tournament_id="myID" /] is a sortable list view of all approved participants.
All these shortcodes are customizable through a set of optional attributes.
Available fields
address [text]: self-explanatory.
affiliation [text]: club or association.
approved [checkbox]: entries become visible in in the list view or through the export filter only afer approved was checked.
birthyear [integer]: self-explanatory
city [text]: self-explanatory.
custom1, custom2, custom3, custom4, custom5 [text]: if anything is missing.
email [text]: comma-separated list of user names to notify of a new participant.
fee_is_paid [checkbox]: self-explanatory.
firstname [text]: self-explanatory.
id [read-only]: an integer that serves as primary key and is incremented with every registration. Use it to separate entries if people register twice.
ip [read-only]: The remote IP of the submitter through wptournregform. May be useful for security checks.
lastname [text]: self-explanatory.
message [textarea]: self-explanatory
phone1 [text]: self-explanatory
phone2 [text]: self-explanatory
postcode [integer]: self-explanatory
protected [checkbox]: if checked, all contact data of the particiapant are suppressed in list view.
rating1 [integer]: a rating that is used to calculate ranking lists.
rating2 [integer]: another rating that is used to calculate ranking lists.
time [read-only]: a timestamp that records the exact date and time of submitting.
It is advisable not to misuse fields since there are some internal checks on the values. Use the custom fields instead. It is hard to say what the length of input fields is in characters as this depends on what is going to. But all are of reasonable length for their purpose.
Attributes
wptournregedit:
tournament_id (required).
display_fields a comma-separated list of field names in the order of view.
wptournregexport:
tournament_id (required).
all if set to any value the list shows all enries, otherwise the ones with a checked approved flag only.
class adds a space separated list of custom CSS classes to the form.
css adds a style attribute with custom CSS to the form.
id adds a custom CSS id to the form.
fields_set a comma-separated list of fields which get ignored if empty.
filename the name of the export file.
format a plain text string where all field names preceded by a percent sign (%fieldname) get replaced by the respective field values.
wptournregform:
tournament_id (required).
backlink adds a backlink to the plugin’s project page.
class adds a space separated list of custom CSS classes to the form.
css adds a style attribute with custom CSS to the form.
id adds a custom CSS id to the form.
disabled submit and reset buttons are disabled if set to any value.
email a comma-separated list of login names who get an E-mail notification if somebody registeres.
wptournreglist:
tournament_id (required).
all if set to any value the list shows all enries, otherwise the ones with a checked approved flag only.
backlink adds a backlink to the plugin’s project page if set to any value.
class adds a space separated list of custom CSS classes to the form.
css adds a style attribute with custom CSS to the form.
id adds a custom CSS id to the list.
display_fields a comma-separated list of fields on view in that particular order.
headings a comma-separated list of column headings in that particular order.
protected_fields a comma-separated list of fields that are suppressed if the protected flag is set in the database for a certain user.
notsortable the columns are sorttable by default. This is suppressed if set to any value.
wptournregfield:
checked checks a checkbox if set to any value.
class adds a space separated list of custom CSS classes to the form.
css adds a style attribute with custom CSS to the form.
id adds a custom CSS id to the form.
disabled disables the field if set to any value.
field one of the field names (cf. list above).
label the label of the field.
placeholder the placeholder is shown in an empty field.
required if set to any value the field is marked as required.
Usage
The first example is a registration form. Several wptournregfield shortcodes are wrapped by a wptournregfield one. You can put HTML elements between (fi. fieldsets) in order to design your form:
[wptournregform tournament_id="my_tournament" css_id="my_tournament" email="[email protected]"]
Red labels indicate required fields!
[wptournregfield field="message" label="Your message" placeholder="Whatever you like to tell us." /][/wptournregform]
The next instance is an editor for the data of the tournament. The non-approved players are highlihted in the selection list:
[wptournregedit tournament_id="my_tournament" display_fields="approved,firstname,lastname,affiliation,email,id,time,ip,rating1,phone1,phone2,protected,custom1,message" /]
Next is a list view. Normally you will make an password restricted full list for internal use and a small one for the public. Only approved players are on view:
[wptournreglist tournament_id="my_tournament" display_fields="lastname,firstname,affiliation,email,phone1,phone2,message" headings="Last Name,First Name,Club,E-mail,Phone 1, Phone 2, Message" /]
The next shortcode exports all participants into a csv list which than the is loaded into a tournament manager app (Swiss-Chess in this case). Here also non-approved players get exported. Wrap the field names in sections signs (§) in order to output the respective value.
[wptournregexport tournament_id="my_tournament" all="1" format='"§lastname§, §firstname§";"§affiliation§";"";"";"§rating1§";""' linebreak="1" filename="swiss-chess.txt"]Download Swiss-Chess list[/wptournregexport]
The following shortcode exports a list of all approved participants who have provided you with a mail address in a way you can directly copy and paste into a mail client. See FAQ for issues with some characters!
[wptournregexport tournament_id="my_tournament" format='"§firstname§ §lastname§" LOWER_THAN§email§>,' fields_set="email" filename="mails.txt"]Download mail list (use BCC!)[/wptournregexport]
