1 package BSE::Edit::Product;
3 use base 'BSE::Edit::Article';
7 use BSE::Util::Iterate;
9 use BSE::CfgInfo 'product_options';
10 use BSE::Util::Tags qw(tag_hash tag_article);
11 use constant PRODUCT_CUSTOM_FIELDS_CFG => "product custom fields";
13 our $VERSION = "1.016";
17 BSE::Edit::Product - tags and actions for editing BSE products
21 http://www.example.com/cgi-bin/admin/add.pl ...
25 Article editor subclass for editing Products.
31 retailPrice => "Retail price",
32 wholesalePrice => "Wholesale price",
36 sub generator { 'BSE::Generate::Product' }
38 sub _make_dummy_article {
39 my ($self, $article) = @_;
41 require BSE::DummyProduct;
42 return bless $article, "BSE::DummyProduct";
45 sub base_template_dirs {
46 return ( "products" );
50 my ($self, $article) = @_;
52 my @extras = $self->SUPER::extra_templates($article);
53 push @extras, 'shopitem.tmpl'
54 if grep -f "$_/shopitem.tmpl",
55 BSE::Template->template_dirs($self->{cfg});
57 my $extras = $self->{cfg}->entry('products', 'extra_templates');
58 push @extras, grep /\.(tmpl|html)$/i, split /,/, $extras
65 my ($article, $arg) = @_;
67 my $value = $article->{$arg};
68 defined $value or $value = '';
69 if ($value =~ /\cJ/ && $value =~ /\cM/) {
73 return encode_entities($value);
77 require BSE::TB::Subscriptions;
78 BSE::TB::Subscriptions->all;
81 sub iter_option_values {
82 my ($self, $rcurrent_option, $args) = @_;
87 return $$rcurrent_option->values;
91 my ($object, $args) = @_;
93 my $value = $object->{$args};
94 defined $value or $value = '';
95 if ($value =~ /\cJ/ && $value =~ /\cM/) {
98 escape_html($value, '<>&"');
101 sub tag_dboptionvalue_move {
102 my ($self, $req, $article, $rvalues, $rindex, $args) = @_;
104 $$rindex >= 0 && $$rindex < @$rvalues
105 or return "** dboptionvalue_move only in dboption_values iterator **";
107 my $my_id = $rvalues->[$$rindex]{id};
108 my $base_url = "$ENV{SCRIPT_NAME}?id=$article->{id}&value_id=$my_id&_csrfp=".$req->get_csrf_token("admin_move_option_value") . "&";
110 my $t = $req->cgi->param('_t');
112 and $base_url .= "_t=$t&";
116 $up_url = $base_url . "a_option_value_moveup=1";
119 if ($$rindex < $#$rvalues) {
120 $down_url = $base_url . "a_option_value_movedown=1";
123 my $refresh = $self->refresh_url($article, $req->cgi);
126 return BSE::Arrows::make_arrows($req->cfg, $down_url, $up_url, $refresh, $args, id => $my_id, id_prefix => "prodoptvaluemove");
129 sub tag_dboption_move {
130 my ($self, $req, $article, $roptions, $rindex, $args) = @_;
132 $$rindex >= 0 && $$rindex < @$roptions
133 or return "** dboption_move only in dboptions iterator **";
135 my $my_id = $roptions->[$$rindex]{id};
136 my $base_url = "$ENV{SCRIPT_NAME}?id=$article->{id}&option_id=$my_id&_csrfp=".$req->get_csrf_token("admin_move_option") . "&";
138 my $t = $req->cgi->param('_t');
140 and $base_url .= "_t=$t&";
144 $up_url = $base_url . "a_option_moveup=1";
147 if ($$rindex < $#$roptions) {
148 $down_url = $base_url . "a_option_movedown=1";
151 my $refresh = $self->refresh_url($article, $req->cgi);
154 return BSE::Arrows::make_arrows($req->cfg, $down_url, $up_url, $refresh, $args, id => $my_id, id_prefix => "prodoptmove");
158 my ($self, $rtier, $rprices, $product) = @_;
160 unless ($rprices->{loaded}) {
161 %$rprices = map { $_->tier_id => $_ } $product->prices
163 $rprices->{loaded} = 1;
166 $$rtier or return '** no current tier **';
168 exists $rprices->{$$rtier->id}
171 return $rprices->{$$rtier->id}->retailPrice;
175 my ($self, $req, $article, $data) = @_;
177 $self->_save_price_tiers($req, $article, $data);
178 $self->SUPER::save_more($req, $article, $data);
182 my ($self, $req, $article, $data) = @_;
184 $self->_save_price_tiers($req, $article, $data);
185 $self->SUPER::save_new_more($req, $article, $data);
188 sub _save_price_tiers {
189 my ($self, $req, $article, $data) = @_;
191 $data->{save_pricing_tiers}
194 $req->user_can('edit_field_edit_retailPrice', $article)
197 my @tiers = BSE::TB::Products->pricing_tiers;
199 for my $tier (@tiers) {
200 my $key = "tier_price_" . $tier->id;
201 if (exists $data->{$key} && $data->{$key} =~ /\S/) {
202 $prices{$tier->id} = $data->{$key} * 100;
205 $article->set_prices(\%prices);
209 my ($self, $table_object) = @_;
211 my @cols = $self->SUPER::save_columns($table_object);
212 my @tiers = BSE::TB::Products->pricing_tiers;
214 push @cols, "save_pricing_tiers";
215 push @cols, map { "tier_price_" . $_->id } @tiers;
222 my ($self, $article) = @_;
227 return $article->db_options;
232 These a tags available on admin/edit_* pages specific to products.
238 product I<field> - display the given field from the product being edited.
242 iterator begin dboptions ... dboption I<field> ... iterator end dboptions
244 - iterate over the existing database stored options for the product
248 dboption_move - display arrows to move the current dboption. The span
249 for the arrows is given an id of "prodoptmoveI<option-id>" by default.
253 iterator begin dboptionvalues ... dboptionvalue I<field> ... iterator end dboptionvalues
255 - iterate over the values for the current dboption
259 dboptionvalue_move - display arrows to move the current dboption. The
260 span for the arrows is given an id of "prodoptvaluemoveI<value-id>"
265 dboptionsjson - returns the product options as JSON.
269 iterator begin price_tiers ... price_tier I<field> ... iterator end price_tiers
271 Iterate over the configured price tiers.
277 Return the price at the current price_tier. Returns an empty string
278 if there's no price at this tier.
285 my ($self, $acts, $req, $article, $articles, $msg, $errors) = @_;
287 my $product_opts = product_options($req->cfg);
290 my $mbcs = $cfg->entry('html', 'mbcs', 0);
291 my $tag_hash = $mbcs ? \&tag_hash_mbcs : \&hash_tag;
296 my $dboption_value_index;
297 my $current_option_value;
298 my $it = BSE::Util::Iterate->new;
302 $req->set_variable(product => $article);
305 product => [ \&tag_article, $article, $cfg ],
306 $self->SUPER::low_edit_tags($acts, $req, $article, $articles, $msg,
308 alloptions => join(",", sort keys %$product_opts),
310 ([ \&iter_subs, $req ], 'subscription', 'subscriptions'),
313 single => "dboption",
314 plural => "dboptions",
315 store => \$current_option,
317 index => \$dboption_index,
318 code => [ iter_dboptions => $self, $article ],
323 $self, $req, $article, \@dboptions, \$dboption_index
327 single => "dboptionvalue",
328 plural => "dboptionvalues",
329 data => \@dboption_values,
330 index => \$dboption_value_index,
331 store => \$current_option_value,
332 code => [ iter_option_values => $self, \$current_option ],
335 dboptionsjson => [ tag_dboptionsjson => $self, $article ],
336 dboptionvalue_move =>
338 tag_dboptionvalue_move =>
339 $self, $req, $article, \@dboption_values, \$dboption_value_index
343 single => "price_tier",
344 plural => "price_tiers",
345 code => [ pricing_tiers => "BSE::TB::Products" ],
347 store => \$price_tier,
349 tier_price => [ tag_tier_price => $self, \$price_tier, \%prices, $article ],
354 my ($self, $article, $cgi) = @_;
356 my $base = 'product';
357 my $t = $cgi->param('_t');
358 if ($t && $t =~ /^\w+$/) {
361 return $self->{cfg}->entry('admin templates', $base,
366 my ($self, $article, $cgi) = @_;
368 return $self->{cfg}->entry('admin templates', 'add_product',
369 'admin/edit_product');
372 sub validate_parent {
373 my ($self, $data, $articles, $parent, $rmsg) = @_;
375 my $shopid = $self->{cfg}->entryErr('articles', 'shop');
377 $parent->{generator} eq 'BSE::Generate::Catalog') {
378 $$rmsg = "Products must be in a catalog (not $parent->{generator})";
382 return $self->SUPER::validate_parent($data, $articles, $parent, $rmsg);
385 sub _validate_common {
386 my ($self, $data, $articles, $errors) = @_;
388 $self->SUPER::_validate_common($data, $articles, $errors);
390 for my $col (keys %money_fields) {
391 my $value = $data->{$col};
392 defined $value or next;
393 unless ($value =~ /^\d+(\.\d{1,2})?\s*/) {
394 $errors->{$col} = "$money_fields{$col} invalid";
398 if (defined $data->{options}) {
399 my $avail_options = product_options($self->{cfg});
401 my @bad_opts = grep !$avail_options->{$_},
402 split /,/, $data->{options};
404 $errors->{options} = "Bad product options '". join(",", @bad_opts)."' entered";
409 for my $sub_field (qw(subscription_id subscription_required)) {
410 my $value = $data->{$sub_field};
411 defined $value or next;
412 if ($value ne '-1') {
413 require BSE::TB::Subscriptions;
414 @subs = BSE::TB::Subscriptions->all unless @subs;
415 unless (grep $_->{subscription_id} == $value, @subs) {
416 $errors->{$sub_field} = "Invalid $sub_field value";
420 if (defined $data->{subscription_period}) {
421 my $sub = $data->{subscription_id};
422 if ($data->{subscription_period} !~ /^\d+$/) {
423 $errors->{subscription_period} = "Invalid subscription period, it must be the number of months to subscribe";
425 elsif ($sub != -1 && $data->{subscription_period} < 1) {
426 $errors->{subscription_period} = "Subscription period must be 1 or more when a subscription is selected";
429 if (defined $data->{subscription_usage}) {
430 unless ($data->{subscription_usage} =~ /^[123]$/) {
431 $errors->{subscription_usage} = "Invalid subscription usage";
435 if ($data->{save_pricing_tiers}) {
436 my @tiers = BSE::TB::Products->pricing_tiers;
437 for my $tier (@tiers) {
438 my $key = "tier_price_" . $tier->id;
439 my $value = $data->{$key};
440 defined $value or next;
441 if ($value =~ /\S/ && $value !~ /^\d+(\.\d{1,2})?\s*/) {
442 $errors->{$key} = 'Pricing tier "' . $tier->description . '" price invalid';
447 return !keys %$errors;
451 my ($self, $data, $articles, $errors) = @_;
453 my $ok = $self->SUPER::validate($data, $articles, $errors);
454 $self->_validate_common($data, $articles, $errors);
456 for my $field (qw(title)) {
457 unless ($data->{$field} =~ /\S/) {
458 $errors->{$field} = "No $field entered";
462 return $ok && !keys %$errors;
466 my ($self, $article, $data, $articles, $errors) = @_;
468 $self->SUPER::validate_old($article, $data, $articles, $errors)
471 return !keys %$errors;
474 sub possible_parents {
475 my ($self, $article, $articles) = @_;
480 my $shopid = $self->{cfg}->entryErr('articles', 'shop');
481 # the parents of a catalog can be other catalogs or the shop
482 my $shop = $articles->getByPkey($shopid);
483 my @work = [ $shopid, $shop->{title} ];
485 my ($id, $title) = @{pop @work};
487 $labels{$id} = $title;
488 push @work, map [ $_->{id}, $title.' / '.$_->{title} ],
489 sort { $b->{displayOrder} <=> $a->{displayOrder} }
490 grep $_->{generator} eq 'BSE::Generate::Catalog',
491 $articles->getBy(parentid=>$id);
493 unless ($shop->{generator} eq 'BSE::Generate::Catalog') {
495 delete $labels{$shopid};
497 return (\@values, \%labels);
501 my ($self, $articles) = @_;
507 my ($self, $articles, $article) = @_;
509 return BSE::TB::Products->getByPkey($article->{id});
512 sub default_link_path {
513 my ($self, $article) = @_;
515 $self->{cfg}->entry('uri', 'shop', '/shop');
519 my ($self, $article) = @_;
526 if ($self->{cfg}->entry('shop', 'secureurl_articles', 1)) {
527 $urlbase = $self->{cfg}->entryVar('site', 'secureurl');
531 if ($article->is_dynamic) {
532 (my $extra = $article->title) =~ tr/A-Za-z0-9/-/sc;
533 return "$urlbase/cgi-bin/page.pl?page=$article->{id}&title=".escape_uri($extra);
536 my $shop_uri = $self->link_path($article);
537 return $urlbase.$shop_uri."/shop$article->{id}.html";
540 sub _fill_product_data {
541 my ($self, $req, $data, $src) = @_;
543 for my $money_col (qw(retailPrice wholesalePrice gst)) {
544 if (exists $src->{$money_col}) {
545 if ($src->{$money_col} =~ /^\d+(\.\d\d)?\s*/) {
546 $data->{$money_col} = 100 * $src->{$money_col};
549 $data->{$money_col} = 0;
553 if (exists $src->{leadTime}) {
554 $src->{leadTime} =~ /^\d+\s*$/
555 or $src->{leadTime} = 0;
556 $data->{leadTime} = $src->{leadTime};
558 if (exists $src->{description} && length $src->{description}) {
560 if ($req->user_can('edit_field_edit_description', $data)) {
561 $data->{description} = $src->{description};
565 if (exists $src->{product_code} && length $src->{product_code}) {
567 if ($req->user_can('edit_field_edit_product_code', $data)) {
568 $data->{product_code} = $src->{product_code};
572 for my $field (qw(options subscription_id subscription_period
573 subscription_usage subscription_required
574 weight length width height)) {
575 if (exists $src->{$field}) {
576 $data->{$field} = $src->{$field};
578 elsif ($data == $src) {
580 $data->{$field} = $self->default_value($req, $data, $field);
586 my ($self, $req, $data, $articles) = @_;
588 $self->_fill_product_data($req, $data, $data);
590 return $self->SUPER::fill_new_data($req, $data, $articles);
594 my ($self, $req, $article, $src) = @_;
596 $self->_fill_product_data($req, $article, $src);
598 return $self->SUPER::fill_old_data($req, $article, $src);
601 sub default_template {
602 my ($self, $article, $cfg, $templates) = @_;
604 my $template = $cfg->entry('products', 'template');
606 if $template && grep $_ eq $template, @$templates;
608 return $self->SUPER::default_template($article, $cfg, $templates);
614 return ( 'product flags', $self->SUPER::flag_sections );
617 sub shop_article { 1 }
623 subscription_id => -1,
624 subscription_required => -1,
625 subscription_period => 1,
626 subscription_usage => 3,
639 my ($self, $req, $article, $col) = @_;
641 my $value = $self->SUPER::default_value($req, $article, $col);
642 defined $value and return $value;
644 exists $defaults{$col} and return $defaults{$col};
649 sub type_default_value {
650 my ($self, $req, $col) = @_;
652 my $value = $req->cfg->entry('product defaults', $col);
653 defined $value and return $value;
655 return $self->SUPER::type_default_value($req, $col);
662 description => "Option name",
664 rules => "dh_one_line",
669 description => "Value 1",
670 rules => "dh_one_line",
675 description => "Value 2",
676 rules => "dh_one_line",
681 description => "Value 3",
682 rules => "dh_one_line",
687 description => "Value 4",
688 rules => "dh_one_line",
693 description => "Value 5",
694 rules => "dh_one_line",
701 Actions you can request from add.pl for products.
707 Add a new product option.
709 On failure perform a service error.
711 Requires _csrfp for admin_add_option
713 For Ajax requests (or with a _ parameter) returns JSON like:
717 option: { <option data> },
718 values: [ { value data }, { value data }, ... ]
731 name - Name of the option (required)
735 value1 .. value5 - if any of these are non-blank they are added to the
740 Permission required: bse_edit_prodopt_add
745 my ($self, $req, $article, $articles, $msg, $errors) = @_;
747 $req->check_csrf('admin_add_option')
748 or return $self->csrf_error($req, $article, "admin_add_option", "Add Product Option");
750 $req->user_can(bse_edit_prodopt_add => $article)
751 or return $self->_service_error($req, $article, $articles, "Insufficient product access to add options");
754 $req->validate(fields => \%option_fields,
757 and return $self->_service_error($req, $article, $articles, undef,
761 require BSE::TB::ProductOptions;
762 require BSE::TB::ProductOptionValues;
763 my $option = BSE::TB::ProductOptions->make
765 product_id => $article->{id},
766 name => scalar($cgi->param('name')),
767 display_order => time,
772 for my $value_key (sort grep /^value/, keys %option_fields) {
773 my ($value) = $cgi->param($value_key);
774 if (defined $value && $value =~ /\S/) {
775 my $entry = BSE::TB::ProductOptionValues->make
777 product_option_id => $option->{id},
779 display_order => $order,
781 push @values, $entry;
787 and return $req->json_content
790 option => $option->data_only,
791 values => [ map $_->data_only, @values ]
794 return $self->refresh($article, $cgi, undef, "Option added");
801 rules => "required;positiveint",
806 my ($self, $req, $article, $errors) = @_;
810 $req->validate(fields => \%option_id,
812 my @option_ids = $cgi->param("option_id");
813 unless ($errors->{option_id}) {
815 or $errors->{option_id} = "This request accepts only one option_id";
817 unless ($errors->{option_id}) {
818 require BSE::TB::ProductOptions;
819 $option = BSE::TB::ProductOptions->getByPkey($cgi->param("option_id"));
821 or $errors->{option_id} = "Unknown option id";
823 unless ($errors->{option_id}) {
824 $option->{product_id} = $article->{id}
825 or $errors->{option_id} = "Option doesn't belong to this product";
834 my ($self, $template, $req, $article, $articles, $msg, $errors) = @_;
837 my $option = $self->_get_option($req, $article, \%errors);
839 and return $self->_service_error($req, $article, $articles, undef, \%errors);
841 my $it = BSE::Util::Iterate->new;
845 $self->low_edit_tags(\%acts, $req, $article, $articles, $msg, $errors),
846 option => [ \&tag_hash, $option ],
849 single => "dboptionvalue",
850 plural => "dboptionvalues",
851 code => [ iter_option_values => $self, \$option ],
855 return $req->dyn_response($template, \%acts);
860 Produce a form to edit the given option.
872 option_id - option id. This must belong to the product identified by
877 Template: admin/prodopt_edit
879 Permission required: bse_edit_prodopt_edit
883 sub req_edit_option {
884 my ($self, $req, $article, $articles, $msg, $errors) = @_;
886 $req->user_can(bse_edit_prodopt_edit => $article)
887 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
889 return $self->_common_option('admin/prodopt_edit', $req, $article,
890 $articles, $msg, $errors);
897 description => "Option name",
898 rules => "required;dh_one_line",
903 description => "Default Value",
904 rules => "positiveint"
910 description => "Value",
911 rules => "required;dh_one_line",
917 Saves changes to an option.
919 On failure perform a service error.
921 Requires _csrfp for admin_save_option
923 For Ajax requests (or with a _ parameter), returns JSON like:
927 option: { <option data> },
928 values: [ { value data, value data, ... } ]
941 option_id - id of the option to save, must belong to the product
946 name - new value for the name field
950 default_value - id of the default value
954 save_enabled - if supplied and true, set enabled from the enabled
959 enabled - If supplied and true, enable the option, otherwise disable
960 it. Ignored unless save_enabled is true.
964 valueI<value-id> - set the displayed value for the value record
965 identified by I<value-id>. If these aren't supplied the values aren't
970 Permission required: bse_edit_prodopt_save
974 sub req_save_option {
975 my ($self, $req, $article, $articles) = @_;
979 $req->check_csrf("admin_save_option")
980 or return $self->csrf_error($req, $article, "admin_save_option", "Save Product Option");
982 $req->user_can(bse_edit_prodopt_edit => $article)
983 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
986 my $option = $self->_get_option($req, $article, \%errors);
988 and return $self->_service_error($req, $article, $articles, undef, \%errors, 'FIELD', "req_edit_option");
989 $req->validate(fields => \%option_name,
991 my @values = $option->values;
992 my %fields = map {; "value$_->{id}" => \%option_value } @values;
993 $req->validate(fields => \%fields,
996 my $default_value = $cgi->param('default_value');
997 if (!$errors{default_value} && $default_value) {
998 grep $_->{id} == $default_value, @values
999 or $errors{default_value} = "Unknown value selected as default";
1005 while ($index < 10 && defined $cgi->param("newvalue$index")) {
1006 my $field = "newvalue$index";
1007 my $value = $cgi->param($field);
1008 $req->validate(fields => { $field => \%option_value },
1009 errors => \%errors);
1010 push @new_values, $value;
1016 and return $self->_service_error($req, $article, $articles, undef, \%errors, "FIELD", "req_edit_option");
1018 my $name = $cgi->param("name");
1020 and $option->set_name($name);
1021 defined $default_value
1022 and $option->set_default_value($default_value);
1023 if ($cgi->param("save_enabled")) {
1024 my $enabled = $cgi->param("enabled") ? 1 : 0;
1025 $option->set_enabled($enabled);
1028 for my $value (@values) {
1029 my $new_value = $cgi->param("value$value->{id}");
1030 if (defined $new_value && $new_value ne $value->value) {
1031 $value->set_value($new_value);
1035 my $order = @values ? $values[-1]->display_order : time;
1036 for my $value (@new_values) {
1037 BSE::TB::ProductOptionValues->make
1039 product_option_id => $option->id,
1041 display_order => ++$order,
1046 and return $req->json_content
1049 option => $option->data_only,
1050 values => [ map $_->data_only, @values ],
1053 return $self->refresh($article, $req->cgi, undef,
1054 "Option '" . $option->name . "' saved");
1057 =item a_delconf_option
1059 Produce a form to confirm deletion of the given option.
1071 option_id - option id. This must belong to the product identified by
1076 Template: admin/prodopt_delete
1080 sub req_delconf_option {
1081 my ($self, $req, $article, $articles, $msg, $errors) = @_;
1083 $req->user_can(bse_edit_prodopt_delete => $article)
1084 or return $self->_service_error($req, $article, $articles, "Insufficient product access to delete options");
1086 return $self->_common_option('admin/prodopt_delete', $req, $article,
1087 $articles, $msg, $errors);
1090 =item a_delete_option
1092 Delete the given option.
1094 On failure perform a service error.
1096 Requires _csrfp for admin_delete_option
1098 For Ajax requests (or with a _ parameter), returns JSON like:
1104 Permission required: bse_edit_prodopt_delete
1108 sub req_delete_option {
1109 my ($self, $req, $article, $articles) = @_;
1111 $req->check_csrf("admin_delete_option")
1112 or return $self->csrf_error($req, $article, "admin_delete_option", "Delete Product Option");
1114 $req->user_can(bse_edit_prodopt_delete => $article)
1115 or return $self->_service_error($req, $article, $articles, "Insufficient product access to delete options");
1118 my $option = $self->_get_option($req, $article, \%errors);
1120 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1121 my @values = $option->values;
1123 for my $value (@values) {
1129 and return $req->json_content
1134 return $self->refresh($article, $req->cgi, undef, "Option deleted");
1138 my %add_option_value_fields =
1142 description => "Option id",
1143 rules => "required;positiveint",
1147 description => "Value",
1148 rules => "required;dh_one_line",
1153 =item a_add_option_value
1155 Add a value to a product option.
1157 On failure perform a service error, see BSE::Edit::Article::_service_error.
1159 Requires _csrfp for admin_add_option_value
1161 For Ajax requests returns JSON like
1163 { success: 1, value: (valueobject) }
1165 Standard redirect on success otherwise.
1177 option_id - id of the option to add the value to
1181 value - text of the value to add.
1185 Permission required: bse_edit_prodopt_edit
1189 sub req_add_option_value {
1190 my ($self, $req, $article, $articles, $msg, $errors) = @_;
1192 $req->check_csrf("admin_add_option_value")
1193 or return $self->csrf_error($req, $article, "admin_add_option_value", "Add Product Option Value");
1195 $req->user_can(bse_edit_prodopt_edit => $article)
1196 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1199 $req->validate(fields => \%add_option_value_fields,
1200 errors => \%errors);
1202 my $cgi = $req->cgi;
1203 unless ($errors{option_id}) {
1204 require BSE::TB::ProductOptions;
1205 $option = BSE::TB::ProductOptions->getByPkey($cgi->param("option_id"));
1206 defined $option && $option->{product_id}
1207 or $errors{option_id} = "Bad option id - either unknown or for a different product";
1210 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1212 my $value = $cgi->param("value");
1213 require BSE::TB::ProductOptionValues;
1214 my $entry = BSE::TB::ProductOptionValues->make
1216 product_option_id => $option->{id},
1218 display_order => time,
1222 and return $req->json_content
1225 value => $entry->data_only
1228 return $self->refresh($article, $cgi, undef, "Value added");
1232 my %option_value_id =
1236 rules => "required;positiveint",
1240 sub _get_option_value {
1241 my ($self, $req, $article, $errors) = @_;
1244 my $cgi = $req->cgi;
1245 $req->validate(fields => \%option_value_id,
1247 unless ($errors->{value_id}) {
1248 require BSE::TB::ProductOptionValues;
1249 $option_value = BSE::TB::ProductOptionValues->getByPkey($cgi->param("value_id"));
1251 or $errors->{value_id} = "Unknown option value id";
1254 unless ($errors->{value_id}) {
1255 $option = $option_value->option;
1256 defined $option && $option->{product_id} == $article->{id}
1257 or $errors->{value_id} = "Value has no option or doesn't belong to the product";
1263 return wantarray ? ( $option_value, $option ) : $option_value ;
1266 sub _common_option_value {
1267 my ($self, $template, $req, $article, $articles, $msg, $errors) = @_;
1270 my ($option_value, $option) = $self->_get_option_value($req, $article, \%errors);
1272 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1277 $self->low_edit_tags(\%acts, $req, $article, $articles, $msg, $errors),
1278 option_value => [ \&tag_hash, $option_value ],
1279 option => [ \&tag_hash, $option ],
1282 return $req->dyn_response($template, \%acts);
1285 =item a_edit_option_value
1287 Displays a form to edit the value for a given option.
1295 id - id of the product
1299 value_id - id of he product option value to edit, must belong to the
1304 Template: admin/prodopt_value_edit
1306 Permission required: bse_edit_prodopt_edit
1310 sub req_edit_option_value {
1311 my ($self, $req, $article, $articles, $msg, $errors) = @_;
1313 $req->user_can(bse_edit_prodopt_edit => $article)
1314 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1316 return $self->_common_option_value('admin/prodopt_value_edit', $req,
1317 $article, $articles, $msg, $errors);
1320 my %save_option_value_fields =
1324 rules => "required;dh_one_line",
1329 =item a_save_option_value
1331 Saves changes to an option.
1333 On failure perform a service error.
1335 Requires _csrfp for admin_save_option_value
1337 For Ajax requests (or with a _ parameter), returns JSON like:
1341 value: { value data }
1354 value_id - id of the value to save, must belong to the product
1359 value - new displayed value for the option value.
1363 Permission required: bse_edit_prodopt_edit
1367 sub req_save_option_value {
1368 my ($self, $req, $article, $articles, $msg, $errors) = @_;
1370 $req->check_csrf("admin_save_option_value")
1371 or return $self->csrf_error($req, $article, "admin_save_option_value", "Save Product Option Value");
1373 $req->user_can(bse_edit_prodopt_edit => $article)
1374 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1377 $req->validate(fields => \%save_option_value_fields,
1378 errors => \%errors);
1379 my $option_value = $self->_get_option_value($req, $article, \%errors);
1381 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1383 my $cgi = $req->cgi;
1384 $option_value->{value} = $cgi->param("value");
1385 $option_value->save;
1388 and return $req->json_content
1391 value => $option_value->data_only
1394 return $self->refresh($article, $cgi, undef, "Value saved");
1397 =item a_confdel_option_value
1399 Displays a page confirming deletion of a product option value.
1411 value_id - option value id
1415 Template: admin/prodopt_value_delete
1417 Permission required: bse_edit_prodopt_edit
1421 sub req_confdel_option_value {
1422 my ($self, $req, $article, $articles, $msg, $errors) = @_;
1424 $req->user_can(bse_edit_prodopt_edit => $article)
1425 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1427 return $self->_common_option_value('admin/prodopt_value_delete', $req,
1428 $article, $articles, $msg, $errors);
1431 =item a_delete_option_value
1433 Deletes a product option.
1435 On failure perform a service error.
1437 Requires _csrfp for admin_delete_option_value
1439 For Ajax requests (or with a _ parameter), returns JSON like:
1455 value_id - id of the value to delete, must belong to the product
1460 Permission required: bse_edit_prodopt_edit
1464 sub req_delete_option_value {
1465 my ($self, $req, $article, $articles, $msg, $errors) = @_;
1467 $req->check_csrf("admin_delete_option_value")
1468 or return $self->csrf_error($req, $article, "admin_delete_option_value", "Delete Product Option Value");
1470 $req->user_can(bse_edit_prodopt_edit => $article)
1471 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1474 my $option_value = $self->_get_option_value($req, $article, \%errors);
1476 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1478 $option_value->remove;
1481 and return $req->json_content
1486 return $self->refresh($article, $req->cgi, undef, "Value removed");
1489 sub tag_dboptionsjson {
1490 my ($self, $article) = @_;
1493 my @options = $article->db_options;
1494 my @opt_cols = BSE::TB::ProductOption->columns;
1495 for my $option (@options) {
1496 my $entry = $option->data_only;
1497 $entry->{values} = [ map $_->data_only, $option->values ];
1498 push @result, $entry;
1502 my $json = JSON->new;
1503 return $json->encode(\@result);
1507 my ($self, $req, $article, $articles, $direction) = @_;
1509 $req->check_csrf("admin_move_option")
1510 or return $self->csrf_error($req, $article, "admin_move_option", "Move Product Option");
1512 $req->user_can(bse_edit_prodopt_move => $article)
1513 or return $self->_service_error($req, $article, $articles, "Insufficient product access to move options");
1516 my $option = $self->_get_option($req, $article, \%errors);
1518 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1519 my @options = $article->db_options;
1520 my ($index) = grep $options[$_]{id} == $option->{id}, 0 .. $#options
1521 or return $self->_service_error($req, $article, $articles, "Unknown option id");
1523 $options[$index] = $option;
1525 my $other_index = $index + $direction;
1526 $other_index >= 0 && $other_index < @options
1527 or return $self->_service_error($req, $article, $articles, "Can't move option beyond end");
1529 my $other = $options[$other_index];
1531 ($option->{display_order}, $other->{display_order}) =
1532 ($other->{display_order}, $option->{display_order});
1536 if ($req->is_ajax) {
1537 @options = sort { $a->{display_order} <=> $b->{display_order} } @options;
1538 return return $req->json_content
1541 order => [ map $_->{id}, @options ]
1545 return $self->refresh($article, $req->cgi, undef, "Option moved");
1548 =item a_option_moveup
1550 =item a_option_movedown
1552 Move a product option up/down through the options for a product.
1554 On failure perform a service error.
1556 Requires _csrfp for admin_move_option
1558 For Ajax requests (or with a _ parameter), returns JSON like:
1562 order: [ list of option ids ]
1575 option_id - option id. This must belong to the product identified by
1580 Permission required: bse_edit_prodopt_move
1584 sub req_option_moveup {
1585 my ($self, $req, $article, $articles) = @_;
1587 return $self->_option_move($req, $article, $articles, -1);
1590 sub req_option_movedown {
1591 my ($self, $req, $article, $articles) = @_;
1593 return $self->_option_move($req, $article, $articles, 1);
1596 =item a_option_reorder
1598 Move a product option up/down through the options for a product.
1600 On failure perform a service error.
1602 Requires _csrfp for admin_move_option
1604 For Ajax requests (or with a _ parameter), returns JSON like:
1608 order: [ list of option ids ]
1621 option_ids - option ids separated by commas. These must belong to the
1622 product identified by id.
1626 Permission required: bse_edit_prodopt_move
1630 sub req_option_reorder {
1631 my ($self, $req, $article, $articles) = @_;
1633 $req->check_csrf("admin_move_option")
1634 or return $self->csrf_error($req, $article, "admin_move_option", "Move Product Option");
1636 $req->user_can(bse_edit_prodopt_move => $article)
1637 or return $self->_service_error($req, $article, $articles, "Insufficient product access to move options");
1639 my @options = $article->db_options;
1640 my @order = map { split ',' } $req->cgi->param('option_ids');
1641 my %options = map { $_->{id} => $_ } @options;
1643 for my $id (@order) {
1644 my $option = delete $options{$id}
1646 push @new_options, $option;
1648 push @new_options, sort { $a->{display_order} <=> $b->{display_order} } values %options;
1649 my @display_order = map $_->{display_order}, @options;
1650 for my $index (0 .. $#new_options) {
1651 $new_options[$index]{display_order} = $display_order[$index];
1652 $new_options[$index]->save;
1656 and return $req->json_content
1659 order => [ map $_->{id}, @new_options ]
1662 return $self->refresh($article, $req->cgi, undef, "Options reordered");
1665 sub _option_value_move {
1666 my ($self, $req, $article, $articles, $direction) = @_;
1668 $req->check_csrf("admin_move_option_value")
1669 or return $self->csrf_error($req, $article, "admin_move_option_value", "Move Product Option Value");
1671 $req->user_can(bse_edit_prodopt_edit => $article)
1672 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1675 my ($option_value, $option) = $self->_get_option_value($req, $article, \%errors);
1677 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1678 my @values = $option->values;
1679 my ($index) = grep $values[$_]{id} == $option_value->{id}, 0 .. $#values
1680 or return $self->_service_error($req, $article, $articles, "Unknown option value id");
1682 $values[$index] = $option_value;
1684 my $other_index = $index + $direction;
1685 $other_index >= 0 && $other_index < @values
1686 or return $self->_service_error($req, $article, $articles, "Can't move option value beyond end");
1688 my $other = $values[$other_index];
1690 ($option_value->{display_order}, $other->{display_order}) =
1691 ($other->{display_order}, $option_value->{display_order});
1692 $option_value->save;
1695 # make sure the json gets the new order
1696 @values[$index, $other_index] = @values[$other_index, $index];
1699 and return $req->json_content
1702 order => [ map $_->{id}, @values ]
1705 return $self->refresh($article, $req->cgi, undef, "Value moved");
1708 =item a_option_value_moveup
1710 =item a_option_value_movedown
1712 Move a product option value up/down through the values for a product
1715 On failure perform a service error.
1717 Requires _csrfp for admin_move_option_value
1719 For Ajax requests (or with a _ parameter), returns JSON like:
1723 order: [ list of value ids ]
1736 value_id - option id. This must belong to the product identified by
1741 Permission required: bse_edit_prodopt_edit
1745 sub req_option_value_moveup {
1746 my ($self, $req, $article, $articles) = @_;
1748 return $self->_option_value_move($req, $article, $articles, -1);
1751 sub req_option_value_movedown {
1752 my ($self, $req, $article, $articles) = @_;
1754 return $self->_option_value_move($req, $article, $articles, 1);
1757 =item a_option_value_reorder
1759 Specify a new order for the values belonging to a product option.
1761 On failure perform a service error.
1763 Requires _csrfp for admin_move_option_value
1765 For Ajax requests (or with a _ parameter), returns JSON like:
1769 order: [ list of value ids ]
1782 option_id - the option to reorder values for
1786 value_ids - new order for values specified as value ids separated by
1791 Permission required: bse_edit_prodopt_edit
1795 sub req_option_value_reorder {
1796 my ($self, $req, $article, $articles) = @_;
1798 $req->check_csrf("admin_move_option_value")
1799 or return $self->csrf_error($req, $article, "admin_move_option_value", "Move Product Option Value");
1801 $req->user_can(bse_edit_prodopt_edit => $article)
1802 or return $self->_service_error($req, $article, $articles, "Insufficient product access to edit options");
1805 my $option = $self->_get_option($req, $article, \%errors);
1807 and return $self->_service_error($req, $article, $articles, undef, \%errors);
1808 my @order = map { split ',' } $req->cgi->param('value_ids');
1809 my @values = $option->values;
1810 my %values = map { $_->{id} => $_ } @values;
1812 for my $id (@order) {
1813 my $value = delete $values{$id}
1815 push @new_values, $value;
1817 push @new_values, sort { $a->{display_order} <=> $b->{display_order} } values %values;
1818 my @display_order = map $_->{display_order}, @values;
1819 for my $index (0 .. $#new_values) {
1820 $new_values[$index]{display_order} = $display_order[$index];
1821 $new_values[$index]->save;
1825 and return $req->json_content
1828 option => $option->data_only,
1829 order => [ map $_->{id}, @new_values ]
1832 return $self->refresh($article, $req->cgi, undef, "Values reordered");
1838 my $custom = $self->SUPER::custom_fields();
1840 require DevHelp::Validate;
1841 DevHelp::Validate->import;
1842 return DevHelp::Validate::dh_configure_fields
1846 PRODUCT_CUSTOM_FIELDS_CFG,
1847 BSE::DB->single->dbh,
1851 sub article_actions {
1856 $self->SUPER::article_actions,
1857 a_add_option => 'req_add_option',
1858 a_confdel_option => 'req_confdel_option',
1859 a_del_option => 'req_del_option',
1860 a_edit_option => 'req_edit_option',
1861 a_save_option => 'req_save_option',
1862 a_delconf_option => 'req_delconf_option',
1863 a_delete_option => 'req_delete_option',
1864 a_get_option => 'req_get_option',
1865 a_edit_option_value => 'req_edit_option_value',
1866 a_save_option_value => 'req_save_option_value',
1867 a_confdel_option_value => 'req_confdel_option_value',
1868 a_delete_option_value => 'req_delete_option_value',
1869 a_add_option_value => 'req_add_option_value',
1870 a_option_value_moveup => 'req_option_value_moveup',
1871 a_option_value_movedown => 'req_option_value_movedown',
1872 a_option_value_reorder => 'req_option_value_reorder',
1873 a_option_moveup => 'req_option_moveup',
1874 a_option_movedown => 'req_option_movedown',
1875 a_option_reorder => 'req_option_reorder',
1885 Tony Cook <tony@develop-help.com>