Tracker (트래커) 플러그인
이것은 위키 페이지 내부에 트래커 생성 서식을 표시하도록 하는 트래커 기능에 대한 위키 플러그인 입니다. 서식에 어떤 필드들이 포함될 거인지를 지정할 수 있습니다.
티키6 부터 이 플러그인은 트래커 항목 대신 사전서식적용된 위키 페이지로서 결과를 출력하는 사용자 지정형 서식을 만들기 위한 간단한 방법으로써 사용될 수 있게 되었습니다.
.
Trackerlist 플러그인 - 주어진 트래커 항목을 표시합니다.
사용법
{TRACKER(trackerId, fields, action, showtitle, showdesc, showmandatory, embedded, email, view, url)}user-defined text{TRACKER}
매개변수
매개변수 | 허용되는 값 | 효과 | 버전 |
---|---|---|---|
trackerId | 숫자 | 사용될 트래커의 숫자로 된 ID | |
fields | : 로 구분된 숫자 | 이는 : 로 구분된 필드 ID들의 번호의 목록입니다. 필드 매개변수가 누락된 경우, 가능한 모든 필드가 추가됩니다. 필드 매개변수는 해당 인스턴스에 대하여 상태에따라서만 플러그인이 작동하도록 하기 위하여 비어둘 수 있습니다 | |
sort | y 혹은 n | 필드 매개변수의 순서대로 필드를 표시함. 트래커의 순서가 아님 (기본값 n) | 2.0 |
action | 문자열 | 이는 향식을 승인하기 위한 버튼의 사용자 지정형 이름 (기본: Save(저장)) | |
showtitle | y 혹은 n | 양식의 상단에 트래커 제목을 표시 | |
showdesc | y 혹은 n | 트래커 설명을 표시 | |
showmandatory | y 혹은 n | 필수 필드를 * 로 표시 | |
showstatus | y 혹은 n | 입력 상내 선택을 표시 (기본값: n) | 5.0 |
embedded | y 혹은 n | 페이지????? | |
from¦to¦templates | 트래커 항목이 생성되었을 때 이메일을 보내기 위함. 필드들은 막대기로 분리되며 이 예제에서는 ¦ (파이프 문자)를 사용. *from 은 이메일 혹은 이메일을 포함하는 필드ID, to 는 이메일 혹은 쉼표로 분리된 이메일의 목록 혹은 이메일을 포함하는 필드ID, templates 은 쉼표로 분리된 템플릿의 목록. 이메일을 여러 개의 이메일 주소로 보내는 경우, 각 이메일의 메시지 본문에 대한 템플릿명을 제공해야만 합니다; 즉: 첫번째 템플릿은 첫 번째 to 에 대하여 사용될 것이고, 두 번째 템플릿이 존재하는 경우, 이는 두 번째 from에 대하여 사용될 것입니다 (그렇지 않다면, 마지막에 주어진 템플릿이 사용됩니다). 제목 (subject)은 template_subject.tpl 이 될 것입니다. 모든 템플릿은 templates/mail 디렉터리 안에 있어야만 합니다. 예제: webmaster at my.com¦a@my.com,b@my.com¦ta.tpl,tb.tpl" (templates/mail/tracker_changed_notification.tpl 은 기본서식입니다, 여기서 힌트를 얻으십시오) | ||
url | url | 항목 생성 이후 사용자가 보내지는 url. 파싱에 문제가 있는 경우, URL 주위에 따옴표를 두를 수 있다는 점에 유의하십시오 (예: url="http:/tiki.org"). 티키 4 이상 버전에서는, URL이 itemId 문자열을 포함하는 경우, itemId 문자열은 itemId=xx 와 교체될 것이며 여기서 xx 는 새 (혹은 현재의) itemId (항목 ID) 입니다 | 1.9.8 |
url 이 itemId 를 포함하는 경우, 링크는 itemId 의 값과 함과 더불어 완성될 것입니다 (예: url="mypage&itemId") | 4.0 | ||
values | : 로 구분된 값 | 필드들에 대한 기본 값들의 목록. 첫 번째 값은 첫 번째 필드ID에 상응하고, 두번째는 두번째 필드ID에 상응하게 됩니다. 기본 값은 URL에서 설정될 수 있습니다. 아래를 참조하십시오. | 2.0 |
overwrite | y 혹은 n | 항목의 현재 값을 덮어쓰는 값 | 6.0 |
각 값은 : 를 포함하는 것을 허용하도록 따옴표로 delimit 될 수 있으며 값은 새로운 항목에만 할당됩니다 | 3.0 | ||
preview | 텍스트 | will add a button with the label = the value of preview (or Preview by default). This is useful to see the computed fields of an item | 2.0 |
user-defined text | text | the user-defined text will be displayed when the tracker item will be recorded ( For example, it can be "Thank you") | |
view | user (the string user) or page (the string page) | if =user: will modify the item associated to the user. If trackerId is specified it will be the item of this tracker associated to the current user (2.0). If no trackerId is specify, it will be the user tracker (the tracker associated with the default group)(tw>=1.9.7 | 1.9.7 |
if =page: will modify the item associated to the page, trackerId must be specify | 3.0 | ||
tpl | file.tpl | the name of the templates to display the form with this template. In the template, the smarty variable {$f_id} will be replaced with the appropriate < input> tag. The < form> tag and the submit button are generated by Tiki outside the template | 2.0 |
wiki | pageName | the name of a wiki page that will be the template (like .tpl). This page must have the permission tiki_p_use_as_template assigned to the Anonymous group to be used as a template | 2.0 |
newstatus | c or p or o | will change the status of the item to this value (c for close, p for pending and o for open when the item is saved | 2.0 |
colwidth | numeric | Specify the width (or percentage) of the first column, the label, in the form | 3.x |
target | _blank_, _self_... | targets the window for the resulting address | 2.0 |
itemId | ID | to edit an item | |
ignoreRequestItemId | y or n | to ignore the itemId of the URL (default n) | 6.0 |
autosavefields | numerics separated by : | fields that will be automatically filled with a value at save time | 5.0 |
autosavevalues | values separated with : | values associated to autosavefields | 5.0 |
Note that categories(x) is a special syntax to select the first child category under category x for a category field, in the original use-case the admin would periodically create/move a new category as a subcategory of category x and while that was the case new items would be created with that category | 5.0 | ||
There is also a special syntax preference(x) for the value of preference x | 8.0 | ||
levelupfields | Values separated with : | Used with autosavefields. Specifies fields where the value can only go up, not down, in other words the specified autosavevalue will not take effect if it is lesser or equal to the current value of the field. Useful for PluginTracker Advanced | 8.0 |
outputtowiki | numerics | Specifies a fieldId. If specified, result of the form will be posted to a new wiki page with the name of this new page taken from the input for this specified fieldId. | 6.0 |
outputwiki | valid pagename | For outputtowiki to work, this must be set to the name of a wiki page that is the template for new pages being created. The template can contain {$f_6} for example as placeholders for the inputted value for field 6 | 6.0 |
discarditem | y or n | This is used in conjunction with outputtowiki. The default is n. If set to y, the tracker item that is created is discarded once the wiki page is created. In effect, the tracker is just a vehicle to create form fields to facilitate creating wiki pages. | 6.0 |
registration | y or n | Registration tracker, special capabilities for use in register - this is used in tiki-register.php in tiki 6 | 6.0 |
관리
- You can limit the tracker fields that can be used in this plugin in the field admin panel of the tracker:
"Field is public? for use with trackerlist plugin option
For Tiki 9.x, the User Selector field (the "userId" field in your tracker, perhaps), edit the field, Permissions, Visibility, Visible by All (even though that's counter-intuitive (you want those items private to that use). - If you have a tracker that has only one item per user/IP or if you use the plugin with the param view=user, the plugin will automatically the item if already exists.
예제
{TRACKER(trackerId=1, fields=1:3:4, action=>Send)} Thank for your contribution! {TRACKER}
필드 일부를 사전에 입력해두기
어떤 경우에는 필드들이 자동으로 사전에 채워져있는 트래커 페이지로 이동하기를 원할 수도 있습니다 (예를 들면, SubmitOrder 라고 명명된 저희의 예제와 같은 경우). 이 경우 다음과 같이 URL을 사용할 수도 있습니다
tiki-index.php?page=SubmitOrder&autosavefields=1&autosavevalues=tikiwiki
SubmitOrder 페이지에서, 저장 (save)를 클릭하면 필드 1이 tikiwiki 란 값으로 채워질 것입니다. 필드 1이 multivaluate 된 값이라면 (예: 범주), 그 값은 사용자가 무엇을 하건간에 사용자가 선택한 잠정적 추가 값에 더해질 것입니다.
팁:
이러한 url 의 작성은 'Wiki argument variables' 기능을 사용하여 얻을 수 있습니다
( Advanced Wiki Syntax usage examples 를 살펴보십시오)
tiki-index.php?page=SubmitOrder&autosavefields=2:3&autosavevalues=:Tracker (트래커) 플러그인
또한 url 매개변수를 사용하여 한 URL 에 itemId 를 전송하거나 혹은 jQuery를 사용하기를 원하는 경우 PluginJQ 를 사용하는 방법에 대하여서 PluginTrackerList 를 참고하십시오.
여러 단계를 거쳐 항목 입력하는 방법
한 페이지에서 한 항목의 몇몇 필드를 채워넣고 다른 페이지에서 다른 필드들을 채워넣기를 원하는 경우, url 매개변수를 itemId 선택사항과 함게 사용해야 합니다.
예제 (에서는 SEFUrl - (검색엔진 친화적 URL) 가 활성화된 링크를 사용하고 있습니다):
페이지1
{TRACKER(trackerId=1, fields=1:2:3, url="Page2&itemId") /}
페이지2
{TRACKER(trackerId=1, fields=4:5:6, url="Page3&itemId") /}
페이지3 - the final one that will display the currently submitted itemId:
{TRACKERLIST(trackerId=1, fields=1:2:3:4:5:6) /}
템플릿 작성하는 방법
앞서 언급된 바, {$f_id}
구문을 사용하여 fieldId=id 의 값을 삽입합니다.
ItemId (항목ID) 자체를 삽입하는 것 또한 가능한데, 이는 트래커 플러그인 내부에 담고 있는 새 위키 페이지를 만들 때 유용합니다. 그 방법은 트래커에 자동 증분 필드 를 추가해야 하며 itemId 에는 자동으로 채워질 적절한 선택사항이 있어야 합니다. 이 새로운 필드 컨텐츠 (itemId 값) 은 위에 표시된 구문과 함께 템플릿에 삽입될 수 있습니다.
이 항목에서 TRACKELIST 에서 TRACKER 로 이동하는 방법
{TRACKERLIST(trackerId=1, fields=1:2:3:4:5:6, url="Page1&itemId", show
트래커와 위키의 고급 통합
((PluginTracker Advanced|Tracker (트래커) 플러그인 고급내용))