solidus_friendly_promotions 1.0.0.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '042911d4cf39c2bddcce9c5826f8c8f790e2ca8396cc32d339c7f5c2dea0a834'
+  data.tar.gz: cf2a4ee16b1d40a6d89771de93b37b145bfce413aab7114a0660cdf0c5798d27
+SHA512:
+  metadata.gz: 5ffa465ffa65e01a30adae44873edabe2fa25594b7c3c09beda6e0e2946ed4e8fdbec547dafc4d22974bbeddb0a978a96c65c5c83f3b300d4e9b0473dc809f23
+  data.tar.gz: 601306df6e5de918612d12ed6084d2a6ea2b690d15ef13ff36d826a541dc19dabaf84b62ea74c0065f106baf256089df544e9814fe3ddcc4da5635ffc8e74c60

data/.circleci/config.yml

@@ -0,0 +1,61 @@
+version: '2.1'
+orbs:
+  browser-tools: circleci/browser-tools@1.1
+  solidusio_extensions: solidusio/extensions@volatile
+jobs:
+  lint:
+    executor:
+      name: solidusio_extensions/sqlite-memory
+      ruby_version: '3.0'
+    steps:
+      - checkout
+      - solidusio_extensions/test-branch:
+          command: bundle exec standardrb
+          command_verb: Check code style
+  run-specs-with-mysql:
+    executor:
+      name: solidusio_extensions/mysql
+      ruby_version: '3.1'
+    steps:
+      - browser-tools/install-chrome
+      - checkout
+      - solidusio_extensions/dependencies
+      - solidusio_extensions/run-tests-solidus-current
+      - solidusio_extensions/run-tests-solidus-main
+  run-specs-with-postgres:
+    executor:
+      name: solidusio_extensions/postgres
+      ruby_version: '3.2'
+    steps:
+      - browser-tools/install-chrome
+      - checkout
+      - solidusio_extensions/dependencies
+      - solidusio_extensions/run-tests-solidus-current
+      - solidusio_extensions/run-tests-solidus-main
+  run-specs-with-sqlite:
+    executor:
+      name: solidusio_extensions/sqlite
+      ruby_version: '3.0'
+    steps:
+      - browser-tools/install-chrome
+      - checkout
+      - solidusio_extensions/dependencies
+      - solidusio_extensions/run-tests-solidus-current
+      - solidusio_extensions/run-tests-solidus-main
+workflows:
+  Run specs on supported Solidus versions:
+    jobs:
+      - lint
+      - run-specs-with-postgres
+      - run-specs-with-mysql
+      - run-specs-with-sqlite
+  Weekly run specs against main:
+    jobs:
+      - run-specs-with-sqlite
+    triggers:
+      - schedule:
+          cron: 0 0 * * 4
+          filters:
+            branches:
+              only:
+                - main

data/.gem_release.yml

@@ -0,0 +1,5 @@
+bump:
+  recurse: false
+  file: 'lib/solidus_friendly_promotions/version.rb'
+  message: Bump SolidusFriendlyPromotions to %{version}
+  tag: true

data/.github/stale.yml

@@ -0,0 +1 @@
+_extends: .github

data/.github_changelog_generator

@@ -0,0 +1,2 @@
+issues=false
+exclude-labels=infrastructure

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+\#*
+*~
+.#*
+.DS_Store
+.idea
+.project
+.sass-cache
+coverage
+Gemfile.lock
+Gemfile-local
+tmp
+nbproject
+pkg
+*.swp
+spec/dummy
+spec/examples.txt
+/sandbox
+.rvmrc
+.ruby-version
+.ruby-gemset

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,29 @@
+inherit_from: .rubocop_todo.yml
+
+require:
+  - solidus_dev_support/rubocop
+
+AllCops:
+  NewCops: disable
+
+
+RSpec/MultipleExpectations:
+  Max: 10
+
+RSpec/MultipleMemoizedHelpers:
+  Max: 12
+
+RSpec/NamedSubject:
+  Enabled: false
+
+RSpec/MessageSpies:
+  Enabled: false
+
+RSpec/ContextWording:
+  Enabled: false
+
+RSpec/NestedGroups:
+  Max: 5
+
+RSpec/LetSetup:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,157 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --exclude-limit 10000`
+# on 2023-07-25 15:26:43 UTC using RuboCop version 1.54.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/promotion_rule_spec.rb'
+
+# Offense count: 1
+Lint/DuplicateMethods:
+  Exclude:
+    - 'app/models/solidus_friendly_promotions/promotion.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Lint/RedundantCopDisableDirective:
+  Exclude:
+    - 'lib/generators/solidus_friendly_promotions/install/install_generator.rb'
+
+# Offense count: 8
+# Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
+# SupportedStyles: snake_case, normalcase, non_integer
+# AllowedIdentifiers: capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
+Naming/VariableNumber:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/rules/first_repeat_purchase_since_spec.rb'
+
+# Offense count: 1
+RSpec/AnyInstance:
+  Exclude:
+    - 'spec/jobs/solidus_friendly_promotions/promotion_code_batch_job_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: IgnoredMetadata.
+RSpec/DescribeClass:
+  Exclude:
+    - 'spec/lib/solidus_friendly_promotions/testing_support/factories_spec.rb'
+    - 'spec/models/promotion/integration_spec.rb'
+
+# Offense count: 2
+RSpec/ExpectInHook:
+  Exclude:
+    - 'spec/jobs/solidus_friendly_promotions/promotion_code_batch_job_spec.rb'
+    - 'spec/models/solidus_friendly_promotions/promotion_code/batch_builder_spec.rb'
+
+# Offense count: 7
+# Configuration parameters: AssignmentOnly.
+RSpec/InstanceVariable:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/promotion_spec.rb'
+
+# Offense count: 2
+RSpec/IteratedExpectation:
+  Exclude:
+    - 'spec/jobs/solidus_friendly_promotions/promotion_code_batch_job_spec.rb'
+
+# Offense count: 2
+RSpec/LeakyConstantDeclaration:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/promotion_rule_spec.rb'
+
+# Offense count: 3
+RSpec/MessageChain:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/rules/first_order_spec.rb'
+
+# Offense count: 4
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 12
+
+# Offense count: 1
+RSpec/OverwritingSetup:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/calculators/flexi_rate_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedExampleGroupBody:
+  Exclude:
+    - 'spec/lib/solidus_friendly_promotions/configuration_spec.rb'
+
+# Offense count: 2
+RSpec/RepeatedExampleGroupDescription:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/calculators/flat_rate_spec.rb'
+
+# Offense count: 1
+RSpec/SubjectStub:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/promotion_code/batch_builder_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: IgnoreNameless, IgnoreSymbolicNames.
+RSpec/VerifiedDoubles:
+  Exclude:
+    - 'spec/models/solidus_friendly_promotions/calculators/percent_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: Include.
+# Include: db/**/*.rb
+Rails/CreateTableWithTimestamps:
+  Exclude:
+    - 'db/migrate/20230725074235_create_shipping_rate_discounts.rb'
+
+# Offense count: 7
+# Configuration parameters: Include.
+# Include: app/models/**/*.rb
+Rails/HasManyOrHasOneDependent:
+  Exclude:
+    - 'app/models/solidus_friendly_promotions/promotion.rb'
+    - 'app/models/solidus_friendly_promotions/promotion_action.rb'
+    - 'app/models/solidus_friendly_promotions/promotion_category.rb'
+    - 'app/models/solidus_friendly_promotions/promotion_code.rb'
+
+# Offense count: 7
+# Configuration parameters: IgnoreScopes, Include.
+# Include: app/models/**/*.rb
+Rails/InverseOf:
+  Exclude:
+    - 'app/models/solidus_friendly_promotions/promotion.rb'
+    - 'app/models/solidus_friendly_promotions/rules/line_item_product.rb'
+    - 'app/models/solidus_friendly_promotions/rules/line_item_taxon.rb'
+    - 'app/models/solidus_friendly_promotions/rules/product.rb'
+    - 'app/models/solidus_friendly_promotions/rules/store.rb'
+    - 'app/models/solidus_friendly_promotions/rules/taxon.rb'
+    - 'app/models/solidus_friendly_promotions/rules/user.rb'
+
+# Offense count: 2
+# This cop supports unsafe autocorrection (--autocorrect-all).
+Rails/ReflectionClassName:
+  Exclude:
+    - 'app/models/solidus_friendly_promotions/promotion_rules_user.rb'
+    - 'app/models/solidus_friendly_promotions/rules/user.rb'
+
+# Offense count: 9
+# Configuration parameters: ForbiddenMethods, AllowedMethods.
+# ForbiddenMethods: decrement!, decrement_counter, increment!, increment_counter, insert, insert!, insert_all, insert_all!, toggle!, touch, touch_all, update_all, update_attribute, update_column, update_columns, update_counters, upsert, upsert_all
+Rails/SkipsModelValidations:
+  Exclude:
+    - 'lib/solidus_friendly_promotions/testing_support/friendly_order_factory.rb'
+    - 'spec/models/solidus_friendly_promotions/promotion_code_batch_spec.rb'
+    - 'spec/models/solidus_friendly_promotions/promotion_code_spec.rb'
+    - 'spec/models/solidus_friendly_promotions/promotion_spec.rb'
+
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 148

data/.standard.yml

@@ -0,0 +1,4 @@
+ruby_version: 3.0
+ignore:
+  - 'sandbox/**/*'
+  - 'spec/dummy/**/*'

data/CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

data/Gemfile

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+branch = ENV.fetch("SOLIDUS_BRANCH", "main")
+gem "solidus", github: "solidusio/solidus", branch: branch
+
+# The solidus_frontend gem has been pulled out since v3.2
+gem "solidus_frontend", github: "solidusio/solidus_frontend" if branch == "master"
+gem "solidus_frontend" if branch >= "v3.2" # rubocop:disable Bundler/DuplicatedGem
+
+# Needed to help Bundler figure out how to resolve dependencies,
+# otherwise it takes forever to resolve them.
+# See https://github.com/bundler/bundler/issues/6677
+gem "rails", ">0.a"
+
+# Provides basic authentication functionality for testing parts of your engine
+gem "solidus_auth_devise"
+
+case ENV.fetch("DB", nil)
+when "mysql"
+  gem "mysql2"
+when "postgresql"
+  gem "pg"
+else
+  gem "sqlite3"
+end
+
+# While we still support Ruby < 3 we need to workaround a limitation in
+# the 'async' gem that relies on the latest ruby, since RubyGems doesn't
+# resolve gems based on the required ruby version.
+gem "async", "< 3" if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("3")
+
+gemspec
+
+# Use a local Gemfile to include development dependencies that might not be
+# relevant for the project or for other contributors, e.g. pry-byebug.
+#
+# We use `send` instead of calling `eval_gemfile` to work around an issue with
+# how Dependabot parses projects: https://github.com/dependabot/dependabot-core/issues/1658.
+send(:eval_gemfile, "Gemfile-local") if File.exist? "Gemfile-local"

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2023 Martin Meyerhoff
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name Solidus nor the names of its contributors may be used to
+      endorse or promote products derived from this software without specific
+      prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/MIGRATING.md

@@ -0,0 +1,134 @@
+# Migrating from Solidus' promotion system to SolidusFriendlyPromotions
+
+The system is designed to completely replace the Solidus promotion system. Follow these steps to migrate your store to the gem:
+
+## Install solidus_friendly_promotions
+
+Add the following line to your `Gemfile`:
+
+```rb
+gem "solidus_friendly_promotions"
+```
+
+Then run
+
+```sh
+bundle install
+bundle exec rails generate solidus_friendly_promotions:install
+```
+
+This will install the extension. It will add new tables, and new routes. It will also generate an initializer in `config/initializers/solidus_friendly_promotions.rb`.
+
+For the time being, comment out the following lines:
+
+```rb
+# Spree::Config.order_contents_class = "SolidusFriendlyPromotions::SimpleOrderContents"
+# Spree::Config.promotion_adjuster_class = "SolidusFriendlyPromotions::OrderDiscounter"
+```
+
+This makes sure that the behavior of the current promotion system does not change - yet.
+
+## Migrate existing promotions
+
+Now, run the promotion migrator:
+
+```sh
+bundle exec rails solidus_friendly_promotions:migrate_existing_promotions
+```
+
+This will create equivalents of the legacy promotion configuration in SolidusFriendlyPromotions.
+
+Now, change `config/initializers/solidus_friendly_promotions.rb` to use your new promotion configuration:
+
+## Change store behavior to use SolidusFriendlyPromotions
+
+```rb
+# Stops running the stock `Spree::PromotionHandler::Cart`
+Spree::Config.order_contents_class = "SolidusFriendlyPromotions::SimpleOrderContents"
+# Adjusts all items in an order according to the currently eligible promotions
+Spree::Config.promotion_adjuster_class = "SolidusFriendlyPromotions::OrderDiscounter"
+```
+
+From a user's perspective, your promotions should work as before.
+
+Before you create new promotions, migrate the adjustments and order promotions in your database:
+
+```rb
+bundle exec rails solidus_friendly_promotions:migrate_adjustments:up
+bundle exec rails solidus_friendly_promotions:migrate_order_promotions:up
+
+```
+
+Check your `spree_adjustments` table for correctness. If things went wrong, you should be able to roll back with
+
+```rb
+bundle exec rails solidus_friendly_promotions:migrate_adjustments:down
+bundle exec rails solidus_friendly_promotions:migrate_order_promotions:down
+```
+
+Both of these tasks only work if every promotion and promotion action have an equivalent in SolidusFrienndlyPromotions. Promotion Actions are connected to their originals using the `SolidusFriendlyPromotions#original_promotion_action_id`, Promotions are connected to their originals using the  `SolidusFriendlyPromotions#original_promotion_id`.
+
+## Migrating custom rules and actions
+
+If you have custom promotion rules or actions, you need to create new promotion rules and actions.
+
+> [!IMPORTANT]
+> SolidusFriendlyPromotions currently only supports actions that discount line items and shipments. If you have actions that add line items, or create order-level adjustments, we currently have no support for that.
+
+In our experience, using the two actions can do almost all the things necessary, since they are customizable using calculators.
+
+Rules share a lot of the previous API. If you make use of `#actionable?`, you might want to migrate your rule to be a line-item level rule:
+
+```rb
+class MyRule < Spree::PromotionRule
+  def actionable?(promotable)
+    promotable.quantity > 3
+  end
+end
+```
+
+would become:
+
+```rb
+class MyNewRule < SolidusFriendlyShipping::PromotionRule
+  include LineItemLevelRule
+  def eligible?(promotable)
+    promotable.quantity > 3
+  end
+end
+```
+
+Now, create your own Promotion conversion map:
+
+```rb
+require 'solidus_friendly_promotions/promotion_map'
+
+MY_PROMOTION_MAP = SolidusFriendlyPromotions::PROMOTION_MAP.deep_merge(
+  rules: {
+    MyRule => MyNewRule
+  }
+)
+```
+
+The value of the conversion map can also be a callable that takes the original promotion rule and should return a new promotion rule.
+
+```rb
+require 'solidus_friendly_promotions/promotion_map'
+
+MY_PROMOTION_MAP = SolidusFriendlyPromotions::PROMOTION_MAP.deep_merge(
+  rules: {
+    MyRule => ->(old_promotion_rule) {
+      MyNewRule.new(preferred_quantity: old_promotion_rule.preferred_count)
+    }
+  }
+)
+```
+
+You can now run our migrator with your map:
+
+```rb
+require 'solidus_friendly_promotions/promotion_migrator'
+require 'my_promotion_map'
+
+SolidusFriendlyPromotions::PromotionMigrator.new(MY_PROMOTION_MAP).call
+```

data/README.md

@@ -0,0 +1,144 @@
+# Solidus Friendly Promotions
+
+[![CircleCI](https://circleci.com/gh/friendlycart/solidus_friendly_promotions.svg?style=shield)](https://circleci.com/gh/friendlycart/solidus_friendly_promotions)
+
+This extension replaces Solidus core's promotion system. It is intended as both a research project and a working alternative to how promotions work in core.
+
+The basic architecture is very similar to the one in core Solidus, but with a few decisive tweaks, which I'll explain in the coming sections.
+
+## Architecture
+
+This extension centralizes promotion handling in the order updater. A service class, the `SolidusFriendlyPromotions::OrderDiscounter` applies the current promotion configuration to the order, adjusting or removing adjustments as necessary.
+
+In Solidus Core, Promotion adjustments get recalculated twice on every change to the cart; once in `Spree::OrderContents#after_add_or_remove` and in `Spree::OrderUpdater#update_promotions`. To make things more complicated, `Spree::OrderContents` leverages the `Spree::PromotionHandler#cart`, while the order updater goes through `Spree::Adjustment#recalculate`.
+
+The design decision here is to make the code path easier to follow, and consequently to make it more performant ("Make it easy, then make it fast").
+
+`SolidusFriendlyPromotions::Promotion` objects have rules and actions, just like `Spree::Promotion`. However, both rules and actions work slightly differently.
+
+### Promotion lanes
+
+Promotions get applied by "lane". Promotions within a lane conflict with each other, whereas promotions that do not share a lane will apply sequentially in the order of the lanes. By default these are "pre", "default" and "post", but you can configure this using the SolidusFriendlyPromotions initializer:
+
+```rb
+SolidusFriendlyPromotions.configure do |config|
+  config.preferred_lanes = {
+    pre: 0,
+    default: 1,
+    grogu: 2,
+    post: 3
+  }
+end
+```
+
+### Promotion Rules
+
+Promotion rules can be applicable to either `Spree::Order`, `Spree::LineItem`, or `Spree::Shipment` objects. If they are applicable, they will be asked for eligibility. Rules applicable to orders are processed first. If a promotion has a rule that makes it ineligible for an order, line items and shipments will not be adjusted. If there are no rules that are applicable, the promotion will be considered eligible.
+
+### Promotion Actions
+
+There are only two actions by default that should cover most use cases: `AdjustLineItem` and `AdjustShipment`. Ther is no action that creates order-level adjustments, as this feature of core Solidus has proven to be very difficult for customer service and finance departments due to the difficulty of accruing order-level adjustments to individual line items when e.g. processing returns. In order to give a fixed discount to all line items in an order, use the `AdjustLineItem` action with the `DistributedAmount` calculator.
+
+Both actions are calculable. By setting their `calculator` to one of the classes provided, a great range of discount possibilities is maintained.
+
+### Connecting promotions to orders
+
+When there is a join record `SolidusFriendlyPromotions::OrderPromotion`, the promotion and the order will be "connected", and the promotion will be applied even if it does not `apply_automatically` (see below). There's a difference to Solidus' system here in that promotions are not automatically connected to orders when they apply.
+
+One way of connecting orders to promotions is via a promotion code.
+
+### Promotion categories
+
+Promotion categories simply allow admins to group promotion actions. They have no further significance with regards to the functionality of the promotion system. This is the same behavior as in core.
+
+
+## Installation
+
+Add solidus_friendly_promotions to your Gemfile:
+
+```ruby
+gem 'solidus_friendly_promotions', github: 'friendlycart/solidus_friendly_promotion', branch: 'main'
+```
+
+Once this project is out of the research phase, a proper gem release will follow.
+
+Bundle your dependencies and run the installation generator:
+
+```shell
+bin/rails generate solidus_friendly_promotions:install
+```
+
+This will create the tables for this extension. It will also replace the promotion administration system under
+`/admin/promotions` with a new one that needs `turbo-rails`.
+
+It will also create an initializer within which Solidus is configured to use this extension's `SimpleOrderContents` and `OrderDiscounter` classes. Feel free to override with your own implementations!
+
+## Usage
+
+Add a promotion using the admin. Add rules and actions, and observe promotions getting applied how you'd expect them to.
+
+In the admin screen, you can set a number of attributes on your promotion:
+- Name: The name of the promotion. The `name` attribute will also be used to generate adjustment labels. In multi-lingual stores, you probably want different promotions per language for this reason.
+
+- Description: This is purely informative. Some stores use `description` in order display information about this promotion to customers, but there is nothing in core Solidus that does it.
+
+- Start and End: Outside of the time range between `starts_at` and `expires_at`, the promotion will not be eligible to any order.
+
+- Usage Limit: `usage_limit` controls to how many orders this promotion can be applied, independent of promotion code or user. This is most commonly used to limit the risk of losing too much revenue with a particular promotion.
+
+- Path: `path` is a URL path that connects the promotion to the order upon visitation. Not currently implemented in either Solidus core or this extension.
+
+- Per Code Usage Limit: How often each code can be used. Useful for limiting how many orders can be placed with a single promotion code.
+
+- Apply Automatically: Whether this promotion should apply automatically. This means that the promotion is checked for eligibility every time the customer's order is recalculated. Promotion Codes and automatic applications are incompatible.
+
+- Promotion Category: Used to group promotions in the admin view.
+
+## Development
+
+### Testing the extension
+
+First bundle your dependencies, then run `bin/rake`. `bin/rake` will default to building the dummy
+app if it does not exist, then it will run specs. The dummy app can be regenerated by using
+`bin/rake extension:test_app`.
+
+```shell
+bin/rake
+```
+
+To run [Rubocop](https://github.com/bbatsov/rubocop) static code analysis run
+
+```shell
+bundle exec rubocop
+```
+
+When testing your application's integration with this extension you may use its factories.
+You can load Solidus core factories along with this extension's factories using this statement:
+
+```ruby
+SolidusDevSupport::TestingSupport::Factories.load_for(SolidusFriendlyPromotions::Engine)
+```
+
+### Running the sandbox
+
+To run this extension in a sandboxed Solidus application, you can run `bin/sandbox`. The path for
+the sandbox app is `./sandbox` and `bin/rails` will forward any Rails commands to
+`sandbox/bin/rails`.
+
+Here's an example:
+
+```
+$ bin/rails server
+=> Booting Puma
+=> Rails 6.0.2.1 application starting in development
+* Listening on tcp://127.0.0.1:3000
+Use Ctrl-C to stop
+```
+
+### Releasing new versions
+
+Please refer to the [dedicated page](https://github.com/solidusio/solidus/wiki/How-to-release-extensions) in the Solidus wiki.
+
+## License
+
+Copyright (c) 2023 Martin Meyerhoff, released under the New BSD License.

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "solidus_dev_support/rake_tasks"
+SolidusDevSupport::RakeTasks.install
+
+task default: "extension:specs"

data/app/assets/config/solidus_friendly_promotions/manifest.js

@@ -0,0 +1,7 @@
+//= link solidus_friendly_promotions.js
+//= link solidus_friendly_promotions/controllers/application.js
+//= link solidus_friendly_promotions/controllers/index.js
+//= link solidus_friendly_promotions/controllers/calculator_tiers_controller.js
+//= link solidus_friendly_promotions/controllers/flash_controller.js
+//= link solidus_friendly_promotions/controllers/product_option_values_controller.js
+//= link solidus_friendly_promotions/jquery/option_value_picker.js