@@ -86,7 +86,7 @@ |
||
| 86 | 86 | * |
| 87 | 87 | * @see toolkit.MySQL#getInsertID() |
| 88 | 88 | * @throws DatabaseException |
| 89 | - * @return integer |
|
| 89 | + * @return null|string |
|
| 90 | 90 | */ |
| 91 | 91 | public function assignEntryId() |
| 92 | 92 | { |
@@ -57,7 +57,7 @@ discard block |
||
| 57 | 57 | * |
| 58 | 58 | * @param string $type |
| 59 | 59 | * The field handle, that is, `field.{$handle}.php` |
| 60 | - * @return string|boolean |
|
| 60 | + * @return string|false |
|
| 61 | 61 | */ |
| 62 | 62 | public static function __getClassPath($type) |
| 63 | 63 | { |
@@ -111,7 +111,7 @@ discard block |
||
| 111 | 111 | * @throws DatabaseException |
| 112 | 112 | * @param array $fields |
| 113 | 113 | * Associative array of field names => values for the Field object |
| 114 | - * @return integer|boolean |
|
| 114 | + * @return false|string |
|
| 115 | 115 | * Returns a Field ID of the created Field on success, false otherwise. |
| 116 | 116 | */ |
| 117 | 117 | public static function add(array $fields) |
@@ -138,7 +138,7 @@ discard block |
||
| 138 | 138 | * @param array $settings |
| 139 | 139 | * An associative array of settings, where the key is the column name |
| 140 | 140 | * and the value is the value. |
| 141 | - * @return boolean |
|
| 141 | + * @return PDOStatement |
|
| 142 | 142 | * True on success, false on failure |
| 143 | 143 | */ |
| 144 | 144 | public static function saveSettings($field_id, $settings) |
@@ -22,7 +22,7 @@ discard block |
||
| 22 | 22 | * @param array $fields |
| 23 | 23 | * Associative array of field names => values for the Page |
| 24 | 24 | * @throws DatabaseException |
| 25 | - * @return integer|boolean |
|
| 25 | + * @return false|string |
|
| 26 | 26 | * Returns the Page ID of the created Page on success, false otherwise. |
| 27 | 27 | */ |
| 28 | 28 | public static function add(array $fields) |
@@ -43,7 +43,7 @@ discard block |
||
| 43 | 43 | * |
| 44 | 44 | * @param string $handle |
| 45 | 45 | * The handle of the page |
| 46 | - * @return integer |
|
| 46 | + * @return string |
|
| 47 | 47 | * The Page title |
| 48 | 48 | */ |
| 49 | 49 | public static function fetchTitleFromHandle($handle) |
@@ -62,7 +62,7 @@ discard block |
||
| 62 | 62 | * |
| 63 | 63 | * @param string $handle |
| 64 | 64 | * The handle of the page |
| 65 | - * @return integer |
|
| 65 | + * @return string |
|
| 66 | 66 | * The Page ID |
| 67 | 67 | */ |
| 68 | 68 | public static function fetchIDFromHandle($handle) |
@@ -116,7 +116,7 @@ discard block |
||
| 116 | 116 | * |
| 117 | 117 | * @param string $name |
| 118 | 118 | * Name of the template |
| 119 | - * @return mixed |
|
| 119 | + * @return string|false |
|
| 120 | 120 | * String, which is the path to the template if the template is found, |
| 121 | 121 | * false otherwise |
| 122 | 122 | */ |
@@ -512,10 +512,10 @@ discard block |
||
| 512 | 512 | * |
| 513 | 513 | * @param integer|array $page_id |
| 514 | 514 | * The ID of the Page, or an array of ID's |
| 515 | - * @param array $select (optional) |
|
| 515 | + * @param string[] $select (optional) |
|
| 516 | 516 | * Accepts an array of columns to return from `tbl_pages`. If omitted, |
| 517 | 517 | * all columns from the table will be returned. |
| 518 | - * @return array|null |
|
| 518 | + * @return integer|null |
|
| 519 | 519 | * An associative array of Page information with the key being the column |
| 520 | 520 | * name from `tbl_pages` and the value being the data. If multiple Pages |
| 521 | 521 | * are found, an array of Pages will be returned. If no Pages are found |
@@ -30,7 +30,7 @@ discard block |
||
| 30 | 30 | * An associative of settings for a section with the key being |
| 31 | 31 | * a column name from `tbl_sections` |
| 32 | 32 | * @throws DatabaseException |
| 33 | - * @return integer |
|
| 33 | + * @return false|string |
|
| 34 | 34 | * The newly created Section's ID |
| 35 | 35 | */ |
| 36 | 36 | public static function add(array $settings) |
@@ -184,7 +184,7 @@ discard block |
||
| 184 | 184 | * |
| 185 | 185 | * @param string $handle |
| 186 | 186 | * The handle of the section |
| 187 | - * @return integer |
|
| 187 | + * @return string |
|
| 188 | 188 | * The Section ID |
| 189 | 189 | */ |
| 190 | 190 | public static function fetchIDFromHandle($handle) |
@@ -277,7 +277,7 @@ discard block |
||
| 277 | 277 | * @param integer $field_id |
| 278 | 278 | * the field ID of the linked section's linked field. |
| 279 | 279 | * @throws DatabaseException |
| 280 | - * @return boolean |
|
| 280 | + * @return PDOStatement |
|
| 281 | 281 | */ |
| 282 | 282 | public static function removeSectionAssociation($field_id) |
| 283 | 283 | { |
@@ -72,7 +72,7 @@ |
||
| 72 | 72 | * Overrides the default `initialiseLog()` method and writes |
| 73 | 73 | * logs to manifest/logs/install |
| 74 | 74 | * |
| 75 | - * @param null $filename |
|
| 75 | + * @param string $filename |
|
| 76 | 76 | * @return boolean|void |
| 77 | 77 | * @throws Exception |
| 78 | 78 | */ |
@@ -127,6 +127,9 @@ discard block |
||
| 127 | 127 | return $this->filteringForm; |
| 128 | 128 | } |
| 129 | 129 | |
| 130 | + /** |
|
| 131 | + * @param Section $section |
|
| 132 | + */ |
|
| 130 | 133 | public function createFilteringDuplicator($section) |
| 131 | 134 | { |
| 132 | 135 | $div = new XMLElement('div'); |
@@ -145,6 +148,9 @@ discard block |
||
| 145 | 148 | $this->filteringForm->appendChild($div); |
| 146 | 149 | } |
| 147 | 150 | |
| 151 | + /** |
|
| 152 | + * @param XMLElement $wrapper |
|
| 153 | + */ |
|
| 148 | 154 | private function createFieldFilters(&$wrapper, $section) |
| 149 | 155 | { |
| 150 | 156 | $filters = $_GET['filter']; |
@@ -284,6 +290,9 @@ discard block |
||
| 284 | 290 | return $comparisons; |
| 285 | 291 | } |
| 286 | 292 | |
| 293 | + /** |
|
| 294 | + * @param XMLElement $wrapper |
|
| 295 | + */ |
|
| 287 | 296 | private function createFilterSuggestions(&$wrapper, $data) |
| 288 | 297 | { |
| 289 | 298 | $ul = new XMLElement('ul'); |
@@ -184,7 +184,7 @@ |
||
| 184 | 184 | * |
| 185 | 185 | * @param string $handle |
| 186 | 186 | * The handle of the section |
| 187 | - * @return integer |
|
| 187 | + * @return string |
|
| 188 | 188 | * The Section ID |
| 189 | 189 | */ |
| 190 | 190 | public static function fetchIDFromHandle($handle) |
@@ -1222,7 +1222,7 @@ discard block |
||
| 1222 | 1222 | * If the date type is set, only the calendar will be shown in the suggestion dropdown. |
| 1223 | 1223 | * |
| 1224 | 1224 | * @since Symphony 2.6.0 |
| 1225 | - * @return array |
|
| 1225 | + * @return string[] |
|
| 1226 | 1226 | */ |
| 1227 | 1227 | public function fetchSuggestionTypes() |
| 1228 | 1228 | { |
@@ -1337,7 +1337,7 @@ discard block |
||
| 1337 | 1337 | * @link http://dev.mysql.com/doc/refman/5.5/en/regexp.html |
| 1338 | 1338 | * @param string $filter |
| 1339 | 1339 | * The full filter, eg. `regexp: ^[a-d]` |
| 1340 | - * @param array $columns |
|
| 1340 | + * @param string[] $columns |
|
| 1341 | 1341 | * The array of columns that need the given `$filter` applied to. The conditions |
| 1342 | 1342 | * will be added using `OR`. |
| 1343 | 1343 | * @param string $joins |
@@ -1508,7 +1508,7 @@ discard block |
||
| 1508 | 1508 | * The data for this field from it's `tbl_entry_data_{id}` table |
| 1509 | 1509 | * @param integer $entry_id |
| 1510 | 1510 | * The optional id of this field entry instance |
| 1511 | - * @return string|array |
|
| 1511 | + * @return string |
|
| 1512 | 1512 | * The formatted value to be used as the parameter. Note that this can be |
| 1513 | 1513 | * an array or a string. When returning multiple values use array, otherwise |
| 1514 | 1514 | * use string. |
@@ -353,7 +353,7 @@ discard block |
||
| 353 | 353 | * Returns the last insert ID from the previous query. This is |
| 354 | 354 | * the value from an auto_increment field. |
| 355 | 355 | * |
| 356 | - * @return integer |
|
| 356 | + * @return string |
|
| 357 | 357 | * The last interested row's ID |
| 358 | 358 | */ |
| 359 | 359 | public function getInsertID() |
@@ -380,7 +380,7 @@ discard block |
||
| 380 | 380 | * conflicts. By default this is set to false, which will not update the data and |
| 381 | 381 | * would return an SQL error |
| 382 | 382 | * @throws DatabaseException |
| 383 | - * @return boolean |
|
| 383 | + * @return PDOStatement |
|
| 384 | 384 | */ |
| 385 | 385 | public function insert(array $fields, $table, $updateOnDuplicate=false) |
| 386 | 386 | { |
@@ -443,7 +443,7 @@ discard block |
||
| 443 | 443 | * A WHERE statement for this UPDATE statement, defaults to null |
| 444 | 444 | * which will update all rows in the $table |
| 445 | 445 | * @param array $params |
| 446 | - * @return bool |
|
| 446 | + * @return PDOStatement |
|
| 447 | 447 | */ |
| 448 | 448 | public function update($fields, $table, $where = null, $params = array()) |
| 449 | 449 | { |
@@ -469,7 +469,7 @@ discard block |
||
| 469 | 469 | * A WHERE statement for this DELETE statement, defaults to null, |
| 470 | 470 | * which will delete all rows in the $table |
| 471 | 471 | * @throws DatabaseException |
| 472 | - * @return boolean |
|
| 472 | + * @return PDOStatement |
|
| 473 | 473 | */ |
| 474 | 474 | public function delete($table, $where = null, array $params = array()) |
| 475 | 475 | { |
@@ -695,7 +695,7 @@ discard block |
||
| 695 | 695 | * @throws Exception |
| 696 | 696 | * @param string $sql |
| 697 | 697 | * A string containing SQL queries delimited by `;` |
| 698 | - * @return boolean |
|
| 698 | + * @return boolean|null |
|
| 699 | 699 | * If one of the queries fails, false will be returned and no further queries |
| 700 | 700 | * will be executed, otherwise true will be returned. |
| 701 | 701 | */ |