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 2.0 |
20
|
|
|
*/ |
21
|
|
|
public static $backend = null; |
22
|
|
|
|
23
|
|
|
/** |
24
|
|
|
* @var int The ID for this entry. |
25
|
|
|
* |
26
|
|
|
* @api |
27
|
|
|
* @since 2.0 |
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
|
25 |
|
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
|
25 |
|
$endpoint = apply_filters( 'gravityview_directory_endpoint', 'entry' ); |
69
|
|
|
|
70
|
25 |
|
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 2.0 |
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
|
61 |
|
public function as_entry() { |
92
|
61 |
|
return $this->entry; |
93
|
|
|
} |
94
|
|
|
|
95
|
|
|
/** |
96
|
|
|
* Return the link to this entry in the supplied context. |
97
|
|
|
* |
98
|
|
|
* @api |
99
|
|
|
* @since 2.0 |
100
|
|
|
* |
101
|
|
|
* @param \GV\View|null $view The View context. |
102
|
|
|
* @param \GV\Request $request The Request (current if null). |
103
|
|
|
* @param boolean $track_directory Keep the housing directory arguments intact (used for breadcrumbs, for example). Default: true. |
104
|
|
|
* |
105
|
|
|
* @return string The permalink to this entry. |
106
|
|
|
*/ |
107
|
7 |
|
public function get_permalink( \GV\View $view = null, \GV\Request $request = null, $track_directory = true ) { |
108
|
7 |
|
if ( is_null( $request ) ) { |
109
|
1 |
|
$request = &gravityview()->request; |
110
|
|
|
} |
111
|
|
|
|
112
|
7 |
|
global $post; |
|
|
|
|
113
|
|
|
|
114
|
7 |
|
$args = array(); |
115
|
|
|
|
116
|
7 |
|
$view_id = is_null ( $view ) ? null : $view->ID; |
|
|
|
|
117
|
|
|
|
118
|
7 |
|
$permalink = null; |
119
|
|
|
|
120
|
|
|
/** This is not a regular view. */ |
121
|
7 |
|
if ( ! $request->is_view() ) { |
122
|
|
|
|
123
|
|
|
/** Must be an embed of some sort. */ |
124
|
5 |
|
if ( is_object( $post ) && is_numeric( $post->ID ) ) { |
125
|
1 |
|
$permalink = get_permalink( $post->ID ); |
126
|
1 |
|
$args['gvid'] = $view_id; |
127
|
|
|
} |
128
|
|
|
} |
129
|
|
|
|
130
|
|
|
/** Fallback to regular view base. */ |
131
|
7 |
|
if ( is_null( $permalink ) ) { |
132
|
7 |
|
$permalink = get_permalink( $view_id ); |
133
|
|
|
} |
134
|
|
|
|
135
|
|
|
/** |
136
|
|
|
* @filter `gravityview_directory_link` Modify the URL to the View "directory" context |
137
|
|
|
* @since 1.19.4 |
138
|
|
|
* @param string $link URL to the View's "directory" context (Multiple Entries screen) |
139
|
|
|
* @param int $post_id ID of the post to link to. If the View is embedded, it is the post or page ID |
140
|
|
|
*/ |
141
|
7 |
|
$permalink = apply_filters( 'gravityview_directory_link', $permalink, $request->is_view() ? $view_id : ( $post ? $post->ID : null ) ); |
142
|
|
|
|
143
|
7 |
|
$entry_endpoint_name = \GV\Entry::get_endpoint_name(); |
144
|
7 |
|
$entry_slug = \GravityView_API::get_entry_slug( $this->ID, $this->as_entry() ); |
145
|
|
|
|
146
|
|
|
/** Assemble the permalink. */ |
147
|
7 |
|
if ( get_option( 'permalink_structure' ) && ! is_preview() ) { |
148
|
|
|
/** |
149
|
|
|
* Make sure the $directory_link doesn't contain any query otherwise it will break when adding the entry slug. |
150
|
|
|
* @since 1.16.5 |
151
|
|
|
*/ |
152
|
1 |
|
$link_parts = explode( '?', $permalink ); |
153
|
|
|
|
154
|
1 |
|
$query = ! empty( $link_parts[1] ) ? '?' . $link_parts[1] : ''; |
155
|
|
|
|
156
|
1 |
|
$permalink = trailingslashit( $link_parts[0] ) . $entry_endpoint_name . '/'. $entry_slug .'/' . $query; |
157
|
|
|
} else { |
158
|
7 |
|
$args[ $entry_endpoint_name ] = $entry_slug; |
159
|
|
|
} |
160
|
|
|
|
161
|
7 |
|
if ( $track_directory ) { |
162
|
7 |
|
if ( ! empty( $_GET['pagenum'] ) ) { |
163
|
1 |
|
$args['pagenum'] = intval( $_GET['pagenum'] ); |
|
|
|
|
164
|
|
|
} |
165
|
|
|
|
166
|
7 |
|
if ( $sort = Utils::_GET( 'sort' ) ) { |
167
|
1 |
|
$args['sort'] = $sort; |
168
|
1 |
|
$args['dir'] = Utils::_GET( 'dir' ); |
169
|
|
|
} |
170
|
|
|
} |
171
|
|
|
|
172
|
7 |
|
$permalink = add_query_arg( $args, $permalink ); |
173
|
|
|
|
174
|
|
|
/** |
175
|
|
|
* @filter `gravityview/entry/permalink` The permalink of this entry. |
176
|
|
|
* @since 2.0 |
177
|
|
|
* @param string $permalink The permalink. |
178
|
|
|
* @param \GV\Entry $entry The entry we're retrieving it for. |
179
|
|
|
* @param \GV\View|null $view The view context. |
180
|
|
|
* @param \GV\Request $reqeust The request context. |
181
|
|
|
*/ |
182
|
7 |
|
return apply_filters( 'gravityview/entry/permalink', $permalink, $this, $view, $request ); |
183
|
|
|
} |
184
|
|
|
} |
185
|
|
|
|
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.