seo-links-repository.php
5.41 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
<?php
namespace Yoast\WP\SEO\Repositories;
use Yoast\WP\Lib\Model;
use Yoast\WP\Lib\ORM;
use Yoast\WP\SEO\Models\SEO_Links;
/**
* Class SEO_Links_Repository.
*/
class SEO_Links_Repository {
/**
* Starts a query for this repository.
*
* @return ORM
*/
public function query() {
return Model::of_type( 'SEO_Links' );
}
/**
* Finds all SEO Links by post ID.
*
* @param int $post_id The post ID.
*
* @return SEO_Links[] The SEO Links.
*/
public function find_all_by_post_id( $post_id ) {
return $this->query()
->where( 'post_id', $post_id )
->find_many();
}
/**
* Finds all SEO Links by indexable ID.
*
* @param int $indexable_id The indexable ID.
*
* @return SEO_Links[] The SEO Links.
*/
public function find_all_by_indexable_id( $indexable_id ) {
return $this->query()
->where( 'indexable_id', $indexable_id )
->find_many();
}
/**
* Retrieves an SEO Link by url.
*
* @param string $url The SEO Link's url.
*
* @return SEO_Links|false The SEO Link, or false if none found.
*/
public function find_one_by_url( $url ) {
return $this->query()
->select( 'target_post_id' )
->where( 'url', $url )
->find_one();
}
/**
* Retrieves all SEO Links by target post ID.
*
* @param string $target_post_id The SEO Link's target post ID.
*
* @return SEO_Links[] The SEO Links.
*/
public function find_all_by_target_post_id( $target_post_id ) {
return $this->query()
->where( 'target_post_id', $target_post_id )
->find_many();
}
/**
* Updates the ID of the target indexable of a link.
*
* @param int $link_id The ID of the link to be updated.
* @param int $target_indexable_id The ID of the target indexable.
*
* @return bool Whether or not the update was succeful.
*/
public function update_target_indexable_id( $link_id, $target_indexable_id ) {
return (bool) $this->query()
->set( 'target_indexable_id', $target_indexable_id )
->where( 'id', $link_id )
->update_many();
}
/**
* Clears all SEO Links by post ID.
*
* @param int $post_id The post ID.
*
* @return bool Whether or not the delete was succesfull.
*/
public function delete_all_by_post_id( $post_id ) {
return $this->query()
->where( 'post_id', $post_id )
->delete_many();
}
/**
* Clears all SEO Links by post ID where the indexable id is null.
*
* @param int $post_id The post ID.
*
* @return bool Whether or not the delete was succesfull.
*/
public function delete_all_by_post_id_where_indexable_id_null( $post_id ) {
return $this->query()
->where( 'post_id', $post_id )
->where_null( 'indexable_id' )
->delete_many();
}
/**
* Clears all SEO Links by indexable ID.
*
* @param int $indexable_id The indexable ID.
*
* @return bool Whether or not the delete was succesfull.
*/
public function delete_all_by_indexable_id( $indexable_id ) {
return $this->query()
->where( 'indexable_id', $indexable_id )
->delete_many();
}
/**
* Returns incoming link counts for a number of posts.
*
* @param array $post_ids The post IDs.
*
* @return array An array of associative arrays, each containing a post id and incoming property.
*/
public function get_incoming_link_counts_for_post_ids( $post_ids ) {
return $this->query()
->select_expr( 'COUNT( id )', 'incoming' )
->select( 'target_post_id', 'post_id' )
->where_in( 'target_post_id', $post_ids )
->group_by( 'target_post_id' )
->find_array();
}
/**
* Returns incoming link counts for a number of indexables.
*
* @param array $indexable_ids The indexable IDs.
*
* @return array An array of associative arrays, each containing a indexable id and incoming property.
*/
public function get_incoming_link_counts_for_indexable_ids( $indexable_ids ) {
if ( empty( $indexable_ids ) ) {
return [];
}
// This query only returns ID's with an incoming count > 0. We need to restore any ID's with 0 incoming links later.
$indexable_counts = $this->query()
->select_expr( 'COUNT( id )', 'incoming' )
->select( 'target_indexable_id' )
->where_in( 'target_indexable_id', $indexable_ids )
->group_by( 'target_indexable_id' )
->find_array();
// If the above query fails, do not update anything.
if ( ! \is_array( $indexable_counts ) ) {
return [];
}
// Get all ID's returned from the query and set them as keys for easy access.
$returned_ids = \array_flip( \array_column( $indexable_counts, 'target_indexable_id' ) );
// Loop over the original ID's and search them in the returned ID's. If they don't exist, add them with an incoming count of 0.
foreach ( $indexable_ids as $id ) {
// Cast the ID to string, as the arrays only contain stringified versions of the ID.
$id = \strval( $id );
if ( isset( $returned_ids[ $id ] ) === false ) {
$indexable_counts[] = [
'incoming' => '0',
'target_indexable_id' => $id,
];
}
}
return $indexable_counts;
}
/**
* Deletes all seo links for the given ids.
*
* @param int[] $ids The seo link ids.
*
* @return bool Whether or not the delete was succesfull.
*/
public function delete_many_by_id( $ids ) {
return $this->query()
->where_in( 'id', $ids )
->delete_many();
}
/**
* Insert multiple seo links.
*
* @param SEO_Links[] $links The seo links to be inserted.
*
* @return bool Whether or not the insert was succesfull.
*/
public function insert_many( $links ) {
return $this->query()
->insert_many( $links );
}
}