1
|
|
|
<?php |
|
|
|
|
2
|
|
|
namespace GV; |
3
|
|
|
|
4
|
|
|
/** If this file is called directly, abort. */ |
5
|
|
|
if ( ! defined( 'GRAVITYVIEW_DIR' ) ) { |
6
|
|
|
die(); |
7
|
|
|
} |
8
|
|
|
|
9
|
|
|
/** |
10
|
|
|
* The base \GV\Entry class. |
11
|
|
|
* |
12
|
|
|
* Contains all entry data and some processing and logic rules. |
13
|
|
|
*/ |
14
|
|
|
abstract class Entry { |
15
|
|
|
|
16
|
|
|
/** |
17
|
|
|
* @var string The identifier of the backend used for this entry. |
18
|
|
|
* @api |
19
|
|
|
* @since future |
20
|
|
|
*/ |
21
|
|
|
public static $backend = null; |
22
|
|
|
|
23
|
|
|
/** |
24
|
|
|
* @var int The ID for this entry. |
25
|
|
|
* |
26
|
|
|
* @api |
27
|
|
|
* @since future |
28
|
|
|
*/ |
29
|
|
|
public $ID = null; |
30
|
|
|
|
31
|
|
|
/** |
32
|
|
|
* @var mixed The backing entry. |
33
|
|
|
*/ |
34
|
|
|
protected $entry; |
35
|
|
|
|
36
|
|
|
/** |
37
|
|
|
* Adds the necessary rewrites for single Entries. |
38
|
|
|
* |
39
|
|
|
* @internal |
40
|
|
|
* @return void |
41
|
|
|
*/ |
42
|
1 |
|
public static function add_rewrite_endpoint() { |
43
|
1 |
|
global $wp_rewrite; |
|
|
|
|
44
|
|
|
|
45
|
1 |
|
$endpoint = self::get_endpoint_name(); |
46
|
|
|
|
47
|
|
|
/** Let's make sure the endpoint array is not polluted. */ |
48
|
1 |
|
if ( in_array( array( EP_ALL, $endpoint, $endpoint ), $wp_rewrite->endpoints ) ) { |
49
|
1 |
|
return; |
50
|
|
|
} |
51
|
|
|
|
52
|
|
|
add_rewrite_endpoint( $endpoint, EP_ALL ); |
53
|
|
|
} |
54
|
|
|
|
55
|
|
|
/** |
56
|
|
|
* Return the endpoint name for a single Entry. |
57
|
|
|
* |
58
|
|
|
* Also used as the query_var for the time being. |
59
|
|
|
* |
60
|
|
|
* @internal |
61
|
|
|
* @return string The name. Default: "entry" |
62
|
|
|
*/ |
63
|
3 |
|
public static function get_endpoint_name() { |
64
|
|
|
/** |
65
|
|
|
* @filter `gravityview_directory_endpoint` Change the slug used for single entries |
66
|
|
|
* @param[in,out] string $endpoint Slug to use when accessing single entry. Default: `entry` |
67
|
|
|
*/ |
68
|
3 |
|
$endpoint = apply_filters( 'gravityview_directory_endpoint', 'entry' ); |
69
|
|
|
|
70
|
3 |
|
return sanitize_title( $endpoint ); |
71
|
|
|
} |
72
|
|
|
|
73
|
|
|
/** |
74
|
|
|
* Construct a \GV\Entry instance by ID. |
75
|
|
|
* |
76
|
|
|
* @param int|string $entry_id The internal entry ID. |
77
|
|
|
* |
78
|
|
|
* @api |
79
|
|
|
* @since future |
80
|
|
|
* @return \GV\Entry|null An instance of this entry or null if not found. |
81
|
|
|
*/ |
82
|
|
|
public static function by_id( $entry_id ) { |
83
|
|
|
return null; |
84
|
|
|
} |
85
|
|
|
|
86
|
|
|
/** |
87
|
|
|
* Return the backing entry object. |
88
|
|
|
* |
89
|
|
|
* @return array The backing entry object. |
90
|
|
|
*/ |
91
|
|
|
public function as_entry() { |
92
|
|
|
return $this->entry; |
93
|
|
|
} |
94
|
|
|
} |
95
|
|
|
|
The PSR-1: Basic Coding Standard recommends that a file should either introduce new symbols, that is classes, functions, constants or similar, or have side effects. Side effects are anything that executes logic, like for example printing output, changing ini settings or writing to a file.
The idea behind this recommendation is that merely auto-loading a class should not change the state of an application. It also promotes a cleaner style of programming and makes your code less prone to errors, because the logic is not spread out all over the place.
To learn more about the PSR-1, please see the PHP-FIG site on the PSR-1.