Merge pull request #675 from splitbrain/depr_dwqsearch

Deprecated dwqsearch updated, no fancy quotes, some phpdocs

16 files changed, 58 insertions, 35 deletions

diff --git a/inc/search.php b/inc/search.php
index be4710237..5489dc2c0 100644
--- a/inc/search.php
+++ b/inc/search.php
@@ -317,25 +317,25 @@ function pathID($path,$keeptxt=false){
  * How the function behaves, depends on the options passed in the $opts
  * array, where the following settings can be used.
  *
- * depth      int     recursion depth. 0 for unlimited
- * keeptxt    bool    keep .txt extension for IDs
- * listfiles  bool    include files in listing
- * listdirs   bool    include namespaces in listing
- * pagesonly  bool    restrict files to pages
- * skipacl    bool    do not check for READ permission
- * sneakyacl  bool    don't recurse into nonreadable dirs
- * hash       bool    create MD5 hash for files
- * meta       bool    return file metadata
- * filematch  string  match files against this regexp
- * idmatch    string  match full ID against this regexp
- * dirmatch   string  match directory against this regexp when adding
- * nsmatch    string  match namespace against this regexp when adding
- * recmatch   string  match directory against this regexp when recursing
- * showmsg    bool    warn about non-ID files
- * showhidden bool    show hidden files too
- * firsthead  bool    return first heading for pages
+ * depth      int     recursion depth. 0 for unlimited                       (default: 0)
+ * keeptxt    bool    keep .txt extension for IDs                            (default: false)
+ * listfiles  bool    include files in listing                               (default: false)
+ * listdirs   bool    include namespaces in listing                          (default: false)
+ * pagesonly  bool    restrict files to pages                                (default: false)
+ * skipacl    bool    do not check for READ permission                       (default: false)
+ * sneakyacl  bool    don't recurse into nonreadable dirs                    (default: false)
+ * hash       bool    create MD5 hash for files                              (default: false)
+ * meta       bool    return file metadata                                   (default: false)
+ * filematch  string  match files against this regexp                        (default: '', so accept everything)
+ * idmatch    string  match full ID against this regexp                      (default: '', so accept everything)
+ * dirmatch   string  match directory against this regexp when adding        (default: '', so accept everything)
+ * nsmatch    string  match namespace against this regexp when adding        (default: '', so accept everything)
+ * recmatch   string  match directory against this regexp when recursing     (default: '', so accept everything)
+ * showmsg    bool    warn about non-ID files                                (default: false)
+ * showhidden bool    show hidden files(e.g. by hidepages config) too        (default: false)
+ * firsthead  bool    return first heading for pages                         (default: false)
  *
- * @param array &$data - Reference to the result data structure
+ * @param array &$data  - Reference to the result data structure
  * @param string $base  - Base usually $conf['datadir']
  * @param string $file  - current file or directory relative to $base
  * @param string $type  - Type either 'd' for directory or 'f' for file
diff --git a/lib/plugins/usermanager/lang/cs/import.txt b/lib/plugins/usermanager/lang/cs/import.txt
index c264ae185..d665838f4 100644
--- a/lib/plugins/usermanager/lang/cs/import.txt
+++ b/lib/plugins/usermanager/lang/cs/import.txt
@@ -2,7 +2,7 @@
 
 Vyžaduje CSV soubor s uživateli obsahující alespoň 4 sloupce.
 Sloupce obsahují (v daném pořadí): user-id, celé jméno, emailovou adresu, seznam skupin.
-Položky CSV musí být odděleny čárkou (,) a řetězce umístěny v uvozovkách (""). Zpětné lomítko (\) lze použít pro escapování.
+Položky CSV musí být odděleny čárkou (,) a řetězce umístěny v uvozovkách (%%""%%). Zpětné lomítko (\) lze použít pro escapování.
 Pro získání příkladu takového souboru využijte funkci "Exportovat uživatele" výše.
 Záznamy s duplicitním user-id budou ignorovány.
 
diff --git a/lib/plugins/usermanager/lang/de-informal/import.txt b/lib/plugins/usermanager/lang/de-informal/import.txt
index 6fd6b8d8c..bc8887193 100644
--- a/lib/plugins/usermanager/lang/de-informal/import.txt
+++ b/lib/plugins/usermanager/lang/de-informal/import.txt
@@ -1,7 +1,7 @@
 ===== Massenimport von Benutzern =====
 
 Dieser Import benötigt eine CSV-Datei mit mindestens vier Spalten. Diese Spalten müssen die folgenden Daten (in dieser Reihenfolge) enthalten: Benutzername, Name, E-Mailadresse und Gruppenzugehörigkeit.
-Die CSV-Felder müssen durch ein Komma (,) getrennt sein. Die Zeichenfolgen müssen von Anführungszeichen ("") umgeben sein. Ein Backslash (\) kann zum Maskieren benutzt werden.
+Die CSV-Felder müssen durch ein Komma (,) getrennt sein. Die Zeichenfolgen müssen von Anführungszeichen (%%""%%) umgeben sein. Ein Backslash (\) kann zum Maskieren benutzt werden.
 Für eine Beispieldatei kannst Du die "Benutzer exportieren"-Funktion oben benutzen. Doppelte Benutzername werden ignoriert.
 
 Ein Passwort wird generiert und den einzelnen, erfolgreich importierten Benutzern zugemailt.
\ No newline at end of file
diff --git a/lib/plugins/usermanager/lang/de/import.txt b/lib/plugins/usermanager/lang/de/import.txt
index bf0d2922e..7faca3b9a 100644
--- a/lib/plugins/usermanager/lang/de/import.txt
+++ b/lib/plugins/usermanager/lang/de/import.txt
@@ -1,7 +1,7 @@
 ===== Benutzer-Massenimport =====
 
 Um mehrere Benutzer gleichzeitig zu importieren, wird eine CSV-Datei mit den folgenden vier Spalten benötigt (In dieser Reihenfolge): Benutzer-ID, Voller Name, E-Mail-Adresse und Gruppen.
-Die CSV-Felder sind Kommata-separiert (,) und mit Anführungszeichen eingefasst ("). Mit Backslashes (\) können Sonderzeichen maskiert werden.
+Die CSV-Felder sind Kommata-separiert (,) und mit Anführungszeichen eingefasst (%%"%%). Mit Backslashes (\) können Sonderzeichen maskiert werden.
 Ein Beispiel für eine gültige Datei kann mit der Benutzer-Export-Funktion oben generiert werden.
 Doppelte Benutzer-IDs werden ignoriert.
 
diff --git a/lib/plugins/usermanager/lang/en/import.txt b/lib/plugins/usermanager/lang/en/import.txt
index 2087083e0..360a0689b 100644
--- a/lib/plugins/usermanager/lang/en/import.txt
+++ b/lib/plugins/usermanager/lang/en/import.txt
@@ -2,7 +2,7 @@
 
 Requires a CSV file of users with at least four columns.
 The columns must contain, in order: user-id, full name, email address and groups.
-The CSV fields should be separated by commas (,) and strings delimited by quotation marks ("").  Backslash (\) can be used for escaping.
+The CSV fields should be separated by commas (,) and strings delimited by quotation marks (%%""%%).  Backslash (\) can be used for escaping.
 For an example of a suitable file, try the "Export Users" function above.  
 Duplicate user-ids will be ignored.
 
diff --git a/lib/plugins/usermanager/lang/eo/import.txt b/lib/plugins/usermanager/lang/eo/import.txt
index 61c2c74de..09fbe6911 100644
--- a/lib/plugins/usermanager/lang/eo/import.txt
+++ b/lib/plugins/usermanager/lang/eo/import.txt
@@ -2,7 +2,7 @@
 
 Tio ĉi postulas CSV-dosiero de uzantoj kun minimume kvar kolumnoj.
 La kolumnoj devas enhavi, laŭorde: uzant-id, kompleta nomo, retadreso kaj grupoj.
-La CSV-kampoj devos esti apartitaj per komoj (,) kaj ĉenoj devas esti limigitaj per citiloj (""). Retroklino (\) povas esti uzata por eskapo.
+La CSV-kampoj devos esti apartitaj per komoj (,) kaj ĉenoj devas esti limigitaj per citiloj (%%""%%). Retroklino (\) povas esti uzata por eskapo.
 Por ekzemplo de taŭga dosiero, provu la funkcion "Eksporti uzantojn" supre.
 Duobligitaj uzant-id estos preteratentataj.
 
diff --git a/lib/plugins/usermanager/lang/fr/import.txt b/lib/plugins/usermanager/lang/fr/import.txt
index 191bb8370..a1eb8f858 100644
--- a/lib/plugins/usermanager/lang/fr/import.txt
+++ b/lib/plugins/usermanager/lang/fr/import.txt
@@ -3,7 +3,7 @@
 Requière un fichier [[wpfr>CSV]] d'utilisateurs avec un minimum de quatre colonnes.
 Les colonnes doivent comporter, dans l'ordre : identifiant, nom complet, adresse de courriel et groupes.
 
-Les champs doivent être séparés par une virgule (,), les chaînes sont délimitées par des guillemets (""). On peut utiliser la balance inverse (\) comme caractère d'échappement.
+Les champs doivent être séparés par une virgule (,), les chaînes sont délimitées par des guillemets (%%""%%). On peut utiliser la balance inverse (\) comme caractère d'échappement.
 Pour obtenir un exemple de fichier acceptable, essayer la fonction "Exporter les utilisateurs" ci dessus.
 
 Les identifiants dupliqués seront ignorés.
diff --git a/lib/plugins/usermanager/lang/hu/import.txt b/lib/plugins/usermanager/lang/hu/import.txt
index f204f6a1e..0210112e8 100644
--- a/lib/plugins/usermanager/lang/hu/import.txt
+++ b/lib/plugins/usermanager/lang/hu/import.txt
@@ -2,7 +2,7 @@
 
 Szükséges egy legalább 4 oszlopot tartalmazó, felhasználókat tartalmazó fájl.
 Az oszlopok kötelező tartalma, sorrendben: felhasználói azonosító, teljes név, e-mailcím és csoport.
-A CSV-mezőket vesszővel (,) kell elválasztani, a szövegeket idézőjelek ("") közé kell tenni. A fordított törtvonal (\) használható feloldójelnek. 
+A CSV-mezőket vesszővel (,) kell elválasztani, a szövegeket idézőjelek (%%""%%) közé kell tenni. A fordított törtvonal (\) használható feloldójelnek.
 Megfelelő mintafájl megtekintéséhez próbáld ki a "Felhasználók exportálása" funkciót fentebb.
 A duplán szereplő felhasználói azonosítók kihagyásra kerülnek.
 
diff --git a/lib/plugins/usermanager/lang/ja/import.txt b/lib/plugins/usermanager/lang/ja/import.txt
index 751e515ac..6af87c263 100644
--- a/lib/plugins/usermanager/lang/ja/import.txt
+++ b/lib/plugins/usermanager/lang/ja/import.txt
@@ -2,7 +2,7 @@
 
 少なくとも４列のユーザーCSVファイルが必要です。
 列の順序：ユーザーID、氏名、電子メールアドレス、グループ。
-CSVフィールドはカンマ（,）区切り、文字列は引用符（""）区切りです。
+CSVフィールドはカンマ（,）区切り、文字列は引用符（%%""%%）区切りです。
 エスケープにバックスラッシュ（\）を使用できます。
 適切なファイル例は、上記の"エクスポートユーザー"機能で試して下さい。 
 重複するユーザーIDは無視されます。
diff --git a/lib/plugins/usermanager/lang/ko/import.txt b/lib/plugins/usermanager/lang/ko/import.txt
index 44fe392d0..6d077dfb8 100644
--- a/lib/plugins/usermanager/lang/ko/import.txt
+++ b/lib/plugins/usermanager/lang/ko/import.txt
@@ -2,7 +2,7 @@
 
 적어도 열 네 개가 있는 사용자의 CSV 파일이 필요합니다.
 열은 다음과 같이 포함해야 합니다: 사용자 id, 실명, 이메일 주소와 그룹.
-CSV 필드는 인용 부호("")로 쉼표(,)와 구분된 문자열로 구분해야 합니다. 백슬래시(\)는 탈출에 사용할 수 있습니다.
+CSV 필드는 인용 부호(%%""%%)로 쉼표(,)와 구분된 문자열로 구분해야 합니다. 백슬래시(\)는 탈출에 사용할 수 있습니다.
 적절한 파일의 예를 들어, 위의 "사용자 목록 내보내기"를 시도하세요.
 중복된 사용자 id는 무시됩니다.
 
diff --git a/lib/plugins/usermanager/lang/nl/import.txt b/lib/plugins/usermanager/lang/nl/import.txt
index 267891098..3a9320ecf 100644
--- a/lib/plugins/usermanager/lang/nl/import.txt
+++ b/lib/plugins/usermanager/lang/nl/import.txt
@@ -1,7 +1,7 @@
 ===== Massa-import van gebruikers =====
 
 Hiervoor is een CSV-bestand nodig van de gebruikers met minstens vier kolommen. De kolommen moeten bevatten, in deze volgorde: gebruikers-id, complete naam, e-mailadres en groepen.
-Het CSV-velden moeten worden gescheiden met komma's (,) en de teksten moeten worden omringd met dubbele aanhalingstekens (""). Backslash (\) kan worden gebruikt om te escapen.
+Het CSV-velden moeten worden gescheiden met komma's (,) en de teksten moeten worden omringd met dubbele aanhalingstekens (%%""%%). Backslash (\) kan worden gebruikt om te escapen.
 Voor een voorbeeld van een werkend bestand, probeer de "Exporteer Gebruikers" functie hierboven.
 Dubbele gebruikers-id's zullen worden genegeerd.
 
diff --git a/lib/plugins/usermanager/lang/ru/import.txt b/lib/plugins/usermanager/lang/ru/import.txt
index dd2b797bc..f2049dd0c 100644
--- a/lib/plugins/usermanager/lang/ru/import.txt
+++ b/lib/plugins/usermanager/lang/ru/import.txt
@@ -2,7 +2,7 @@
 
 Потребуется список пользователей в файле формата CSV, состоящий из 4 столбцов. 
 Столбцы должны быть заполнены следующим образом: user-id, полное имя, эл. почта, группы. 
-Поля CSV должны быть отделены запятой (,), а строки должны быть заключены в кавычки (""). Обратный слэш используется как прерывание. 
+Поля CSV должны быть отделены запятой (,), а строки должны быть заключены в кавычки (%%""%%). Обратный слэш используется как прерывание.
 В качестве примера можете взять список пользователей, экспортированный через «Экспорт пользователей». 
 Повторяющиеся идентификаторы user-id будут игнорироваться.
 
diff --git a/lib/plugins/usermanager/lang/sk/import.txt b/lib/plugins/usermanager/lang/sk/import.txt
index 91fa3e370..2207f6162 100644
--- a/lib/plugins/usermanager/lang/sk/import.txt
+++ b/lib/plugins/usermanager/lang/sk/import.txt
@@ -2,7 +2,7 @@
 
 Vyžaduje CSV súbor používateľov s minimálne 4 stĺpcami.
 Stĺpce musia obsahovať postupne: ID používateľa, meno a priezvisko, emailová adresa a skupiny.
-CVS záznamy by mali byť oddelené čiarkou (,) a reťazce uzavreté úvodzovkami (""). Znak (\) sa používa v spojení so špeciálnymi znakmi.
+CVS záznamy by mali byť oddelené čiarkou (,) a reťazce uzavreté úvodzovkami (%%""%%). Znak (\) sa používa v spojení so špeciálnymi znakmi.
 Príklad vhodného súboru je možné získať funkciou "Export používateľov".
 Duplicitné ID používateľov budú ignorované.
 
diff --git a/lib/plugins/usermanager/lang/zh-tw/import.txt b/lib/plugins/usermanager/lang/zh-tw/import.txt
index a6bb5f6ef..925cdc9d0 100644
--- a/lib/plugins/usermanager/lang/zh-tw/import.txt
+++ b/lib/plugins/usermanager/lang/zh-tw/import.txt
@@ -2,7 +2,7 @@
 
 需提供 CSV 格式的使用者列表檔案（UTF-8 編碼）。
 每列至少 4 欄，依序為：帳號、姓名、電郵、群組。
-各欄以半形逗號 (,) 分隔，有半形逗號的字串可用半形雙引號 ("") 分開，引號可用反斜線 (\) 跳脫。
+各欄以半形逗號 (,) 分隔，有半形逗號的字串可用半形雙引號 (%%""%%) 分開，引號可用反斜線 (\) 跳脫。
 重複的使用者帳號會自動忽略。
 如需要範例檔案，可用上面的「匯出使用者」取得。
 
diff --git a/lib/plugins/usermanager/lang/zh/import.txt b/lib/plugins/usermanager/lang/zh/import.txt
index eacce5a77..243a53e84 100644
--- a/lib/plugins/usermanager/lang/zh/import.txt
+++ b/lib/plugins/usermanager/lang/zh/import.txt
@@ -1,7 +1,7 @@
 ===== 批量导入用户 =====
 
 需要至少有 4 列的 CSV 格式用户列表文件。列必须按顺序包括：用户ID、全名、电子邮件地址和组。
-CSV 域需要用逗号 (,) 分隔，字符串用英文双引号 ("") 分开。反斜杠可以用来转义。
+CSV 域需要用逗号 (,) 分隔，字符串用英文双引号 (%%""%%) 分开。反斜杠可以用来转义。
 可以尝试上面的“导入用户”功能来查看示例文件。重复的用户ID将被忽略。
 
 密码生成后会通过电子邮件发送给每个成功导入的用户。
\ No newline at end of file
diff --git a/lib/scripts/compatibility.js b/lib/scripts/compatibility.js
index 76b135b23..fc020cce8 100644
--- a/lib/scripts/compatibility.js
+++ b/lib/scripts/compatibility.js
@@ -77,9 +77,32 @@ var index = {
 };
 
 var ajax_quicksearch = {
-    init: DEPRECATED_WRAP(dw_qsearch.init, dw_qsearch),
-    clear_results: DEPRECATED_WRAP(dw_qsearch.clear_results, dw_qsearch),
-    onCompletion: DEPRECATED_WRAP(dw_qsearch.onCompletion, dw_qsearch)
+    init: function() {
+        DEPRECATED('Use jQuery().dw_qsearch() instead');
+        jQuery('#qsearch__in').dw_qsearch({
+            output: '#qsearch__out'
+        });
+    },
+    clear_results: function() {
+        DEPRECATED('ajax_quicksearch.clear_results is removed');
+    },
+    onCompletion: function() {
+        DEPRECATED('ajax_quicksearch.onCompletion is removed');
+    }
+};
+var dw_qsearch = {
+    init: function(input, output) {
+        DEPRECATED('Use jQuery().dw_qsearch() instead');
+        jQuery(input).dw_qsearch({
+            output: output
+        });
+    },
+    clear_results: function() {
+        DEPRECATED('dw_qsearch.clear_results is removed');
+    },
+    onCompletion: function() {
+        DEPRECATED('dw_qsearch.onCompletion is removed');
+    }
 };
 
 var linkwiz = {