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 |
||
| 9 | class FoxyStripeProduct extends DataObject |
||
| 10 | { |
||
| 11 | |||
| 12 | /** |
||
| 13 | * @var string |
||
| 14 | */ |
||
| 15 | private static $singular_name = 'Product'; |
||
| 16 | /** |
||
| 17 | * @var string |
||
| 18 | */ |
||
| 19 | private static $plural_name = 'Products'; |
||
| 20 | /** |
||
| 21 | * @var string |
||
| 22 | */ |
||
| 23 | private static $description = 'A product that can be added to the shopping cart'; |
||
| 24 | |||
| 25 | /** |
||
| 26 | * @var array |
||
| 27 | */ |
||
| 28 | private static $db = [ |
||
| 29 | 'Price' => 'Currency', |
||
| 30 | 'Code' => 'Varchar(100)', |
||
| 31 | 'ReceiptTitle' => 'HTMLVarchar(255)', |
||
| 32 | 'Featured' => 'Boolean', |
||
| 33 | 'Available' => 'Boolean', |
||
| 34 | 'DiscountTitle' => 'Varchar(50)' |
||
| 35 | ]; |
||
| 36 | |||
| 37 | /** |
||
| 38 | * @var array |
||
| 39 | */ |
||
| 40 | private static $has_one = [ |
||
| 41 | 'PreviewImage' => 'Image', |
||
| 42 | 'Category' => 'FoxyCartProductCategory' |
||
| 43 | ]; |
||
| 44 | |||
| 45 | /** |
||
| 46 | * @var array |
||
| 47 | */ |
||
| 48 | private static $has_many = [ |
||
| 49 | 'ProductImages' => 'ProductImage', |
||
| 50 | 'ProductOptions' => 'OptionItem', |
||
| 51 | 'OrderDetails' => 'OrderDetail', |
||
| 52 | 'ProductDiscountTiers' => 'ProductDiscountTier' |
||
| 53 | ]; |
||
| 54 | |||
| 55 | /** |
||
| 56 | * @var array |
||
| 57 | */ |
||
| 58 | private static $belongs_many_many = [ |
||
| 59 | 'ProductHolders' => 'ProductHolder' |
||
| 60 | ]; |
||
| 61 | |||
| 62 | /** |
||
| 63 | * @var array |
||
| 64 | */ |
||
| 65 | private static $indexes = [ |
||
| 66 | 'Code' => true, |
||
| 67 | ]; |
||
| 68 | |||
| 69 | /** |
||
| 70 | * @var array |
||
| 71 | */ |
||
| 72 | private static $defaults = [ |
||
| 73 | 'ShowInMenus' => false, |
||
| 74 | 'Available' => true, |
||
| 75 | 'Weight' => '1.0' |
||
| 76 | ]; |
||
| 77 | |||
| 78 | /** |
||
| 79 | * @var array |
||
| 80 | */ |
||
| 81 | private static $summary_fields = [ |
||
| 82 | 'Title', |
||
| 83 | 'Code', |
||
| 84 | 'Price.Nice', |
||
| 85 | 'Category.Title' |
||
| 86 | ]; |
||
| 87 | |||
| 88 | /** |
||
| 89 | * @var array |
||
| 90 | */ |
||
| 91 | private static $searchable_fields = [ |
||
| 92 | 'Title', |
||
| 93 | 'Code', |
||
| 94 | 'Featured', |
||
| 95 | 'Available', |
||
| 96 | 'Category.ID' |
||
| 97 | ]; |
||
| 98 | |||
| 99 | public function fieldLabels($includeRelations = true) |
||
| 100 | { |
||
| 101 | $labels = parent::fieldLabels($includeRelations); |
||
| 102 | |||
| 103 | $labels['Title'] = _t('ProductPage.TitleLabel', 'Name'); |
||
| 104 | $labels['Code'] = _t('ProductPage.CodeLabel', "Code"); |
||
| 105 | $labels['Price.Nice'] = _t('ProductPage.PriceLabel', 'Price'); |
||
| 106 | $labels['Featured.Nice'] = _t('ProductPage.NiceLabel', 'Featured'); |
||
| 107 | $labels['Available.Nice'] = _t('ProductPage.AvailableLabel', 'Available'); |
||
| 108 | $labels['Category.ID'] = _t('ProductPage.IDLabel', 'Category'); |
||
| 109 | $labels['Category.Title'] = _t('ProductPage.CategoryTitleLabel', 'Category'); |
||
| 110 | |||
| 111 | return $labels; |
||
| 112 | } |
||
| 113 | |||
| 114 | /** |
||
| 115 | * @return FieldList |
||
| 116 | */ |
||
| 117 | public function getCMSFields() |
||
| 118 | { |
||
| 119 | $fields = parent::getCMSFields(); |
||
| 120 | |||
| 121 | // allow extensions of ProductPage to override the PreviewImage field description |
||
| 122 | $previewDescription = ($this->stat('customPreviewDescription')) ? $this->stat('customPreviewDescription') : _t('ProductPage.PreviewImageDescription', 'Image used throughout site to represent this product'); |
||
| 123 | |||
| 124 | // Cateogry Dropdown field w/ add new |
||
| 125 | $source = function () { |
||
| 126 | return FoxyCartProductCategory::get()->map()->toArray(); |
||
| 127 | }; |
||
| 128 | $catField = DropdownField::create('CategoryID', _t('ProductPage.Category', 'FoxyCart Category'), $source()) |
||
| 129 | ->setEmptyString('') |
||
| 130 | ->setDescription(_t( |
||
| 131 | 'ProductPage.CategoryDescription', |
||
| 132 | 'Required, must also exist in |
||
| 133 | <a href="https://admin.foxycart.com/admin.php?ThisAction=ManageProductCategories" target="_blank"> |
||
| 134 | FoxyCart Categories |
||
| 135 | </a>. |
||
| 136 | Used to set category specific options like shipping and taxes. Managed in |
||
| 137 | <a href="admin/settings"> |
||
| 138 | Settings > FoxyStripe > Categories |
||
| 139 | </a>' |
||
| 140 | )); |
||
| 141 | if (class_exists('QuickAddNewExtension')) $catField->useAddNew('FoxyCartProductCategory', $source); |
||
| 142 | |||
| 143 | // Product Images gridfield |
||
| 144 | $config = GridFieldConfig_RelationEditor::create(); |
||
| 145 | if (class_exists('GridFieldSortableRows')) $config->addComponent(new GridFieldSortableRows('SortOrder')); |
||
| 146 | if (class_exists('GridFieldBulkImageUpload')) { |
||
| 147 | $config->addComponent(new GridFieldBulkUpload()); |
||
| 148 | $config->getComponentByType('GridFieldBulkUpload')->setUfConfig('folderName', 'Uploads/ProductImages'); |
||
|
|
|||
| 149 | } |
||
| 150 | $prodImagesField = GridField::create( |
||
| 151 | 'ProductImages', |
||
| 152 | _t('ProductPage.ProductImages', 'Images'), |
||
| 153 | $this->ProductImages(), |
||
| 154 | $config |
||
| 155 | ); |
||
| 156 | |||
| 157 | // Product Options field |
||
| 158 | $config = GridFieldConfig_RelationEditor::create(); |
||
| 159 | if (class_exists('GridFieldSortableRows')) { |
||
| 160 | $config->addComponent(new GridFieldSortableRows('SortOrder')); |
||
| 161 | $products = $this->ProductOptions()->sort('SortOrder'); |
||
| 162 | } else { |
||
| 163 | $products = $this->ProductOptions(); |
||
| 164 | } |
||
| 165 | $config->removeComponentsByType('GridFieldAddExistingAutocompleter'); |
||
| 166 | $prodOptField = GridField::create( |
||
| 167 | 'ProductOptions', |
||
| 168 | _t('ProductPage.ProductOptions', 'Options'), |
||
| 169 | $products, |
||
| 170 | $config |
||
| 171 | ); |
||
| 172 | |||
| 173 | // Details tab |
||
| 174 | $fields->addFieldsToTab('Root.Details', [ |
||
| 175 | HeaderField::create('DetailHD', 'Product Details', 2), |
||
| 176 | CheckboxField::create('Available') |
||
| 177 | ->setTitle(_t('ProductPage.Available', 'Available for purchase')) |
||
| 178 | ->setDescription(_t( |
||
| 179 | 'ProductPage.AvailableDescription', |
||
| 180 | 'If unchecked, will remove "Add to Cart" form and instead display "Currently unavailable"' |
||
| 181 | )), |
||
| 182 | TextField::create('Code') |
||
| 183 | ->setTitle(_t('ProductPage.Code', 'Product Code')) |
||
| 184 | ->setDescription(_t( |
||
| 185 | 'ProductPage.CodeDescription', |
||
| 186 | 'Required, must be unique. Product identifier used by FoxyCart in transactions' |
||
| 187 | )), |
||
| 188 | $catField, |
||
| 189 | CurrencyField::create('Price') |
||
| 190 | ->setTitle(_t('ProductPage.Price', 'Price')) |
||
| 191 | ->setDescription(_t( |
||
| 192 | 'ProductPage.PriceDescription', |
||
| 193 | 'Base price for this product. Can be modified using Product Options' |
||
| 194 | )), |
||
| 195 | NumericField::create('Weight') |
||
| 196 | ->setTitle(_t('ProductPage.Weight', 'Weight')) |
||
| 197 | ->setDescription(_t( |
||
| 198 | 'ProductPage.WeightDescription', |
||
| 199 | 'Base weight for this product in lbs. Can be modified using Product Options' |
||
| 200 | )), |
||
| 201 | CheckboxField::create('Featured') |
||
| 202 | ->setTitle(_t('ProductPage.Featured', 'Featured Product')), |
||
| 203 | TextField::create('ReceiptTitle') |
||
| 204 | ->setTitle(_t('ProductPage.ReceiptTitle', 'Product Title for Receipt')) |
||
| 205 | ->setDescription(_t( |
||
| 206 | 'ProductPage.ReceiptTitleDescription', 'Optional' |
||
| 207 | )) |
||
| 208 | ]); |
||
| 209 | |||
| 210 | // Images tab |
||
| 211 | $fields->addFieldsToTab('Root.Images', [ |
||
| 212 | HeaderField::create('MainImageHD', _t('ProductPage.MainImageHD', 'Product Image'), 2), |
||
| 213 | UploadField::create('PreviewImage', '') |
||
| 214 | ->setDescription($previewDescription) |
||
| 215 | ->setFolderName('Uploads/Products') |
||
| 216 | ->setAllowedExtensions(['jpg', 'jpeg', 'gif', 'png']) |
||
| 217 | ->setAllowedMaxFileNumber(1), |
||
| 218 | HeaderField::create('ProductImagesHD', _t('ProductPage.ProductImagesHD' . 'Product Image Gallery'), 2), |
||
| 219 | $prodImagesField |
||
| 220 | ->setDescription(_t( |
||
| 221 | 'ProductPage.ProductImagesDescription', |
||
| 222 | 'Additional Product Images, shown in gallery on Product page' |
||
| 223 | )) |
||
| 224 | ]); |
||
| 225 | |||
| 226 | // Options Tab |
||
| 227 | $fields->addFieldsToTab('Root.Options', [ |
||
| 228 | HeaderField::create('OptionsHD', _t('ProductPage.OptionsHD', 'Product Options'), 2), |
||
| 229 | LiteralField::create('OptionsDescrip', _t( |
||
| 230 | 'Page.OptionsDescrip', |
||
| 231 | '<p>Product Options allow products to be customized by attributes such as size or color. |
||
| 232 | Options can also modify the product\'s price, weight or code.</p>' |
||
| 233 | )), |
||
| 234 | $prodOptField |
||
| 235 | ]); |
||
| 236 | |||
| 237 | if (!$this->DiscountTitle && $this->ProductDiscountTiers()->exists()) { |
||
| 238 | $fields->addFieldTotab('Root.Discounts', new LiteralField("ProductDiscountHeaderWarning", "<p class=\"message warning\">A discount title is required for FoxyCart to properly parse the value. The discounts will not be applied until a title is entered.</p>")); |
||
| 239 | } |
||
| 240 | |||
| 241 | $fields->addFieldToTab('Root.Discounts', TextField::create('DiscountTitle')->setTitle(_t('Product.DiscountTitle', 'Discount Title'))); |
||
| 242 | $discountsConfig = GridFieldConfig_RelationEditor::create(); |
||
| 243 | $discountsConfig->removeComponentsByType('GridFieldAddExistingAutocompleter'); |
||
| 244 | $discountsConfig->removeComponentsByType('GridFieldDeleteAction'); |
||
| 245 | $discountsConfig->addComponent(new GridFieldDeleteAction(false)); |
||
| 246 | $discountGrid = GridField::create('ProductDiscountTiers', 'Product Discounts', $this->ProductDiscountTiers(), $discountsConfig); |
||
| 247 | $fields->addFieldToTab('Root.Discounts', $discountGrid); |
||
| 248 | |||
| 249 | View Code Duplication | if (FoxyCart::store_name_warning() !== null) { |
|
| 250 | $fields->addFieldToTab('Root.Main', LiteralField::create("StoreSubDomainHeaderWarning", _t( |
||
| 251 | 'ProductPage.StoreSubDomainHeaderWarning', |
||
| 252 | "<p class=\"message error\">Store sub-domain must be entered in the <a href=\"/admin/settings/\">site settings</a></p>" |
||
| 253 | )), 'Title'); |
||
| 254 | } |
||
| 255 | |||
| 256 | // allows CMS fields to be extended |
||
| 257 | $this->extend('updateCMSFields', $fields); |
||
| 258 | |||
| 259 | return $fields; |
||
| 260 | } |
||
| 261 | |||
| 262 | 33 | public function onBeforeWrite() |
|
| 263 | { |
||
| 264 | 33 | parent::onBeforeWrite(); |
|
| 265 | 33 | if (!$this->CategoryID) { |
|
| 266 | $default = FoxyCartProductCategory::get()->filter(['Code' => 'DEFAULT'])->first(); |
||
| 267 | $this->CategoryID = $default->ID; |
||
| 268 | } |
||
| 269 | |||
| 270 | //update many_many lists when multi-group is on |
||
| 271 | 33 | if (SiteConfig::current_site_config()->MultiGroup) { |
|
| 272 | $holders = $this->ProductHolders(); |
||
| 273 | $product = ProductPage::get()->byID($this->ID); |
||
| 274 | if (isset($product->ParentID)) { |
||
| 275 | $origParent = $product->ParentID; |
||
| 276 | } else { |
||
| 277 | $origParent = null; |
||
| 278 | } |
||
| 279 | $currentParent = $this->ParentID; |
||
| 280 | if ($origParent != $currentParent) { |
||
| 281 | if ($holders->find('ID', $origParent)) { |
||
| 282 | $holders->removeByID($origParent); |
||
| 283 | } |
||
| 284 | |||
| 285 | } |
||
| 286 | $holders->add($currentParent); |
||
| 287 | } |
||
| 288 | |||
| 289 | 33 | $title = ltrim($this->Title); |
|
| 290 | 33 | $title = rtrim($title); |
|
| 291 | 33 | $this->Title = $title; |
|
| 292 | |||
| 293 | |||
| 294 | 33 | } |
|
| 295 | |||
| 296 | 33 | public function onAfterWrite() |
|
| 297 | { |
||
| 298 | 33 | parent::onAfterWrite(); |
|
| 299 | |||
| 300 | |||
| 301 | 33 | } |
|
| 302 | |||
| 303 | 1 | public function onBeforeDelete() |
|
| 304 | { |
||
| 305 | 1 | if ($this->Status != "Published") { |
|
| 306 | 1 | if ($this->ProductOptions()) { |
|
| 307 | 1 | $options = $this->getComponents('ProductOptions'); |
|
| 308 | 1 | foreach ($options as $option) { |
|
| 309 | $option->delete(); |
||
| 310 | 1 | } |
|
| 311 | 1 | } |
|
| 312 | 1 | if ($this->ProductImages()) { |
|
| 313 | //delete product image dataobjects, not the images themselves. |
||
| 314 | 1 | $images = $this->getComponents('ProductImages'); |
|
| 315 | 1 | foreach ($images as $image) { |
|
| 316 | $image->delete(); |
||
| 317 | 1 | } |
|
| 318 | 1 | } |
|
| 319 | 1 | } |
|
| 320 | 1 | parent::onBeforeDelete(); |
|
| 321 | 1 | } |
|
| 322 | |||
| 323 | 8 | public function validate() |
|
| 324 | { |
||
| 325 | 8 | $result = parent::validate(); |
|
| 326 | |||
| 327 | /*if($this->ID>0){ |
||
| 328 | if($this->Price <= 0) { |
||
| 329 | $result->error('Must set a positive price value'); |
||
| 330 | } |
||
| 331 | if($this->Weight <= 0){ |
||
| 332 | $result->error('Must set a positive weight value'); |
||
| 333 | } |
||
| 334 | if($this->Code == ''){ |
||
| 335 | $result->error('Must set a product code'); |
||
| 336 | } |
||
| 337 | }*/ |
||
| 338 | |||
| 339 | 8 | return $result; |
|
| 340 | } |
||
| 341 | |||
| 342 | public function getCMSValidator() |
||
| 343 | { |
||
| 344 | return new RequiredFields(['CategoryID', 'Price', 'Code']); |
||
| 345 | } |
||
| 346 | |||
| 347 | public static function getGeneratedValue($productCode = null, $optionName = null, $optionValue = null, $method = 'name', $output = false, $urlEncode = false) |
||
| 348 | { |
||
| 349 | $optionName = ($optionName !== null) ? preg_replace('/\s/', '_', $optionName) : $optionName; |
||
| 350 | return (SiteConfig::current_site_config()->CartValidation) |
||
| 351 | ? FoxyCart_Helper::fc_hash_value($productCode, $optionName, $optionValue, $method, $output, $urlEncode) : |
||
| 352 | $optionValue; |
||
| 353 | } |
||
| 354 | |||
| 355 | /** |
||
| 356 | * @return HTMLText |
||
| 357 | */ |
||
| 358 | public function getCartScript() |
||
| 362 | |||
| 363 | public function getDiscountFieldValue() |
||
| 372 | |||
| 373 | /** |
||
| 374 | * @return FoxyStripePurchaseForm |
||
| 375 | */ |
||
| 376 | public function getPurchaseForm() |
||
| 388 | |||
| 389 | } |
Let’s take a look at an example:
In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different implementation of User which does not have a getDisplayName() method, the code will break.
Available Fixes
Change the type-hint for the parameter:
Add an additional type-check:
Add the method to the interface: