Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
1 | <?php |
||
5 | class ImagesWithStyleSelection extends DataObject |
||
|
|||
6 | { |
||
7 | |||
8 | |||
9 | ####################### |
||
10 | ### Names Section |
||
11 | ####################### |
||
12 | |||
13 | private static $singular_name = 'Selection of Images'; |
||
14 | |||
15 | public function i18n_singular_name() |
||
19 | |||
20 | private static $plural_name = 'Selections of Images'; |
||
21 | |||
22 | public function i18n_plural_name() |
||
26 | |||
27 | |||
28 | ####################### |
||
29 | ### Model Section |
||
30 | ####################### |
||
31 | |||
32 | private static $db = [ |
||
33 | 'Title' => 'Varchar(255)', // this needs to be lengthy to avoid the same names ... |
||
34 | 'Description' => 'Text' |
||
35 | ]; |
||
36 | |||
37 | private static $has_one = [ |
||
38 | 'PlaceToStoreImages' => 'Folder' |
||
39 | ]; |
||
40 | |||
41 | private static $many_many = [ |
||
42 | 'StyledImages' => 'ImageWithStyle' |
||
43 | ]; |
||
44 | |||
45 | private static $many_many_extraFields = [ |
||
46 | 'StyledImages' => [ |
||
47 | 'SortOrder' => 'Int', |
||
48 | ] |
||
49 | ]; |
||
50 | |||
51 | public function StyledImages() |
||
55 | |||
56 | ####################### |
||
57 | ### Further DB Field Details |
||
58 | ####################### |
||
59 | |||
60 | private static $indexes = [ |
||
61 | 'Created' => true, |
||
62 | 'Title' => 'unique("Title")' |
||
63 | ]; |
||
64 | |||
65 | private static $defaults = [ |
||
66 | 'Title' => '' |
||
67 | ]; |
||
68 | |||
69 | private static $default_sort = [ |
||
70 | 'Created' => 'DESC' |
||
71 | ]; |
||
72 | |||
73 | private static $required_fields = [ |
||
74 | 'Title' |
||
75 | ]; |
||
76 | |||
77 | private static $searchable_fields = [ |
||
78 | 'Title' => 'PartialMatchFilter' |
||
79 | ]; |
||
80 | |||
81 | |||
82 | ####################### |
||
83 | ### Field Names and Presentation Section |
||
84 | ####################### |
||
85 | |||
86 | private static $field_labels = [ |
||
87 | 'StyledImages' => 'Images to be included' |
||
88 | ]; |
||
89 | |||
90 | private static $field_labels_right = [ |
||
91 | 'StyledImages' => 'Select as many as you like and sort them in the right order' |
||
92 | ]; |
||
93 | |||
94 | private static $summary_fields = [ |
||
95 | 'Title' => 'Name', |
||
96 | 'StyledImages.Count' => 'Number of Images' |
||
97 | ]; |
||
98 | |||
99 | |||
100 | ####################### |
||
101 | ### Casting Section |
||
102 | ####################### |
||
103 | |||
104 | |||
105 | ####################### |
||
106 | ### can Section |
||
107 | ####################### |
||
108 | |||
109 | |||
110 | |||
111 | ####################### |
||
112 | ### write Section |
||
113 | ####################### |
||
114 | |||
115 | |||
116 | |||
117 | |||
118 | View Code Duplication | public function validate() |
|
163 | |||
164 | |||
165 | public function onBeforeWrite() |
||
189 | |||
190 | public function requireDefaultRecords() |
||
195 | |||
196 | |||
197 | ####################### |
||
198 | ### Import / Export Section |
||
199 | ####################### |
||
200 | |||
201 | public function getExportFields() |
||
206 | |||
207 | |||
208 | |||
209 | ####################### |
||
210 | ### CMS Edit Section |
||
211 | ####################### |
||
212 | |||
213 | |||
214 | public function CMSEditLink() |
||
220 | |||
221 | public function CMSAddLink() |
||
227 | |||
228 | |||
229 | public function getCMSFields() |
||
273 | |||
274 | |||
275 | /** |
||
276 | * @return Int |
||
277 | */ |
||
278 | public function ImageCount() |
||
282 | |||
283 | /** |
||
284 | * @return DataList |
||
285 | */ |
||
286 | public function RawImages() |
||
299 | |||
300 | /** |
||
301 | * force the list to use a certain folder ... |
||
302 | * @param string $folderName |
||
303 | * |
||
304 | * @return ImagesWithStyleSelection |
||
305 | */ |
||
306 | public function createFolder($folderName) |
||
314 | } |
||
315 |
You can fix this by adding a namespace to your class:
When choosing a vendor namespace, try to pick something that is not too generic to avoid conflicts with other libraries.