diff --git a/extension/Documentation/UsersManual/Index.rst b/extension/Documentation/UsersManual/Index.rst index df18f6a72a01240e03e86cee39b7707e0a12e8d8..01d9464ba35ee8eb6ab4b92109fefcb849ecc9ee 100644 --- a/extension/Documentation/UsersManual/Index.rst +++ b/extension/Documentation/UsersManual/Index.rst @@ -117,7 +117,7 @@ Form * *Simple* form: the form acts on one record, stored in one table. - * The form will create necessary SQL commands for insert, update and delete automatically. + * The form will create necessary SQL commands for insert, update and delete (only primary record) automatically. * *Advanced* form: the form acts on multiple records, stored in more than one table. @@ -1633,7 +1633,7 @@ Column: _link +---+---+----------+-----------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | |x |New |N |N |Show 'new' icon as image | +---+---+----------+-----------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ -| |x |Delete |D |D |Show 'delete' icon as image | +| |x |Delete |D |D |Show 'delete' icon as image (only the icon, no database record 'delete' functionality) | +---+---+----------+-----------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | |x |Help |H |H |Show 'help' icon as image | +---+---+----------+-----------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ @@ -1773,28 +1773,6 @@ Examples: | SELECT "p:form_person|q:Edit Person:::10:0" AS _link | The Alert will be shown 10 seconds and is not modal. | +------------------------------------------------------------+---------------------------------------------------------------------------+ -Delete -^^^^^^ - -Records will be deleted via `typo3conf/ext/qfq/qfq/api/delete.php` and needs the parameter: - -Mandatory: - -* `table=<table name>` or `form=<form name>` -* `r=<record id>` - -Example: - -:: - - SELECT 'U:table=Person&r=123|q:Do you want delete John Doe?|s|c:n' AS _link - -It's easier to use the shortcut via special columnname `_paged`. - -If the record to delete contains column(s), whose columnname match on `%pathFileName%` and such a column points to a real existing file, - such a file will be deleted too. If the table contains records where the specific file is multiple times referenced, than the file - is not deleted (it would break the still existing references). Multiple references are not found, if they use different colummnnames or tablenames. - Columns: _page[X] ^^^^^^^^^^^^^^^^^ @@ -1864,19 +1842,46 @@ The colum name is composed of the string *page* and a trailing character to spec Column: _paged ^^^^^^^^^^^^^^ -Necessary parameter: - -* `table` or `form` -* r +These column offers a link, with a confirmation question, to delete one record (mode 'table') or a bunch of records +(mode 'form'). After deleting the record(s), the current page will refreshed in the browser. **Syntax** :: - SELECT "U:table=<tablename>&r=<recordId>|q:<question>|..." AS _paged, "U:form=<formname>&r=<recordId>|q:<question>|..." AS _paged + SELECT "U:table=<tablename>&r=<recordId>|q:<question>|..." AS _paged + SELECT "U:form=<formname>&r=<recordId>|q:<question>|..." AS _paged .. +If the record to delete contains column(s), whose columnname match on `%pathFileName%` and such a +column points to a real existing file, such a file will be deleted too. If the table contains records where the specific +file is multiple times referenced, than the file is not deleted (it would break the still existing references). Multiple +references are not found, if they use different colummnnames or tablenames. + +Mode: table +''''''''''' +* `table=<table name>` +* `r=<record id>` + +Deletes the record with id '<record id>' from table '<table name>'. + +Mode: form +'''''''''' +* `form=<form name>` +* `r=<record id>` + +Deletes the record with id '<record id>' from the table specified in form '<form name>' as primary table. +Additional action *formElement* of type *beforeDelete* or *afterDelete* will be fired too. + +Examples: +''''''''' + +:: + + SELECT 'U:table=Person&r=123|q:Do you want delete John Doe?' AS _paged + SELECT 'U:form=person-main&r=123|q:Do you want delete John Doe?' AS _paged + Columns: _Page[X] ^^^^^^^^^^^^^^^^^ @@ -1885,7 +1890,20 @@ Columns: _Page[X] :: - [<page id|alias>[¶m=value&...]] | [text] | [tooltip] | [question parameter] | [class] | [target] | [render mode] | [create sip] "" as _Pagee. + "[<page id|alias>[¶m=value&...]] | [text] | [tooltip] | [question parameter] | [class] | [target] | [render mode]" as _Pagee. + +.. + +Column: _Paged +^^^^^^^^^^^^^^ + +* Similar to `_paged` +* Parameter are position dependent and therefore without a qualifier! + +:: + + "[table=<table name>&r-<record id>[¶m=value&...] | [text] | [tooltip] | [question parameter] | [class] | [render mode]" as _Paged. + "[form=<form name>&r-<record id>[¶m=value&...] | [text] | [tooltip] | [question parameter] | [class] | [render mode]" as _Paged. .. @@ -1984,7 +2002,7 @@ Easily create Email links. :: - 10.sql = select "john.doe@example.com|John Doe" AS _mailto + 10.sql = SELECT "john.doe@example.com|John Doe" AS _mailto ..