Issues (1181)

src/base/AutocompleteInterface.php (22 issues)

1
<?php
2
/**
3
 * Twigfield for Craft CMS
4
 *
5
 * Provides a twig editor field with Twig & Craft API autocomplete
6
 *
7
 * @link      https://nystudio107.com
0 ignored issues
show
The tag in position 1 should be the @copyright tag
Loading history...
8
 * @copyright Copyright (c) 2022 nystudio107
0 ignored issues
show
@copyright tag must contain a year and the name of the copyright holder
Loading history...
9
 */
0 ignored issues
show
PHP version not specified
Loading history...
Missing @category tag in file comment
Loading history...
Missing @package tag in file comment
Loading history...
Missing @author tag in file comment
Loading history...
Missing @license tag in file comment
Loading history...
10
11
namespace nystudio107\twigfield\base;
12
13
use nystudio107\twigfield\models\CompleteItem;
14
15
/**
0 ignored issues
show
Missing short description in doc comment
Loading history...
16
 * @author    nystudio107
0 ignored issues
show
The tag in position 1 should be the @package tag
Loading history...
Content of the @author tag must be in the form "Display Name <[email protected]>"
Loading history...
Tag value for @author tag indented incorrectly; expected 2 spaces but found 4
Loading history...
17
 * @package   twigfield
0 ignored issues
show
Package name "twigfield" is not valid; consider "Twigfield" instead
Loading history...
Tag value for @package tag indented incorrectly; expected 1 spaces but found 3
Loading history...
18
 * @since     1.0.0
0 ignored issues
show
The tag in position 3 should be the @author tag
Loading history...
Tag value for @since tag indented incorrectly; expected 3 spaces but found 5
Loading history...
19
 */
0 ignored issues
show
Missing @category tag in class comment
Loading history...
Missing @license tag in class comment
Loading history...
Missing @link tag in class comment
Loading history...
20
interface AutocompleteInterface
21
{
22
    // Constants
23
    // =========================================================================
24
25
    // Public Methods
26
    // =========================================================================
27
28
    /**
29
     * Generate the complete items
30
     */
0 ignored issues
show
Missing @return tag in function comment
Loading history...
31
    public function generateCompleteItems(): void;
32
33
    /**
34
     * Add a complete item to the $path, which is a . separated namespace for the item
35
     * that indicates where in the associative array the item should appear.
36
     *
37
     * @param CompleteItem $item
0 ignored issues
show
Missing parameter comment
Loading history...
38
     * @param string $path The . delimited path in the autocomplete array to the item; if omitted, will be set to the $item->label
0 ignored issues
show
Expected 7 spaces after parameter type; 1 found
Loading history...
39
     */
0 ignored issues
show
Missing @return tag in function comment
Loading history...
40
    public function addCompleteItem(CompleteItem $item, string $path = ''): void;
41
42
    /**
43
     * Get the array of complete items
44
     *
45
     * @return array
46
     */
47
    public function getCompleteItems(): array;
48
}
49