friendly_id 5.5.1 → 5.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5fd869be5d6d4518b4928f41284ec56c4eca0162a3d0683369ed6789b87206ed
-  data.tar.gz: b349d6f8cbb6d1289c768cf6d38c55ad864b472fc39f08e98baf2389af96e85d
+  metadata.gz: d8a1f043f2634ba82853c8748c13dacf573cf7de6f99c71ede338d9aecd7f424
+  data.tar.gz: '033259395dcc4b75e595c4a81aedf839815768805c8f3d8bc8a2f1cb51df85ed'
 SHA512:
-  metadata.gz: 07ca31c8fc194a8a3b336a8e2fdf63cb69f2ac84f1e8cb3781e35beabd392c8b8100495b9fc07e42a548d4e91d1bbf35aed2f9b51c5d5f65cf59d32cb4f25732
-  data.tar.gz: 776d4a15ae8c7144dbff2b9bc2b9d8f745f22858db397617a58af1bc61bacbdb9cc6e52477dfa7ee88e5457f9bda775a892292c3fe51b49060743e783b74e317
+  metadata.gz: cea6b61fc184a6d8f2c4468282440a7a4499a1af7ff3bb979c3c1659aa401d1459cb5e345e6dd1d56225304a5278b7b93625e619352975735b49385b295ca73f
+  data.tar.gz: fe4b2086cfebce9204cc349c8d0a1b31756fee02da072f2babfb56f87697d1a034be7a568ae78b9ccaf360cc8cf4509c59b9ccac68193dfe52859bb7ed018954

data/Changelog.md

@@ -3,7 +3,10 @@
 We would like to think our many [contributors](https://github.com/norman/friendly_id/graphs/contributors) for
 suggestions, ideas and improvements to FriendlyId.
 
-## Unreleased
+## 5.6.0 (2025-12-07)
+
+* Add: `treat_numeric_as_conflict` option to prevent ambiguous numeric slugs. ([#1037](https://github.com/norman/friendly_id/pull/1037))
+* Fix: history not using `parse_friendly_id`. ([#1020](https://github.com/norman/friendly_id/pull/1020))
 
 ## 5.5.1 (2023-11-13)
 

data/README.md

@@ -39,7 +39,7 @@ FriendlyId offers many advanced features, including:
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'friendly_id', '~> 5.4.0'
+gem 'friendly_id', '~> 5.5.0'
 ```
 
 Note: You MUST use 5.0.0 or greater for Rails 4.0+.
@@ -108,8 +108,8 @@ User.find_each(&:save)
 
 ### `:allow_nil`
 
-You can pass `allow_nil: true` to the `friendly.find()` method if you're want to
-avoid raising `ActiveRecord::RecordNotFound` and accept a `nil`.
+You can pass `allow_nil: true` to the `friendly.find()` method if you want to
+avoid raising `ActiveRecord::RecordNotFound` and accept `nil`.
 
 #### Example
 

data/lib/friendly_id/history.rb

@@ -85,13 +85,13 @@ module FriendlyId
       include ::FriendlyId::FinderMethods
 
       def exists_by_friendly_id?(id)
-        super || joins(:slugs).where(slug_history_clause(id)).exists?
+        super || joins(:slugs).where(slug_history_clause(parse_friendly_id(id))).exists?
       end
 
       private
 
       def first_by_friendly_id(id)
-        super || slug_table_record(id)
+        super || slug_table_record(parse_friendly_id(id))
       end
 
       def slug_table_record(id)

data/lib/friendly_id/slug_generator.rb

@@ -12,6 +12,10 @@ module FriendlyId
         return false if @config.reserved_words.include?(slug)
       end
 
+      if @config.treat_numeric_as_conflict && purely_numeric_slug?(slug)
+        return false
+      end
+
       !@scope.exists_by_friendly_id?(slug)
     end
 
@@ -19,5 +23,16 @@ module FriendlyId
       candidates.each { |c| return c if available?(c) }
       nil
     end
+
+    private
+
+    def purely_numeric_slug?(slug)
+      return false unless slug
+      begin
+        Integer(slug, 10).to_s == slug.to_s
+      rescue ArgumentError, TypeError
+        false
+      end
+    end
   end
 end

data/lib/friendly_id/slugged.rb

@@ -155,6 +155,24 @@ module FriendlyId
   # You can change this with the {FriendlyId::Slugged::Configuration#sequence_separator
   # sequence_separator} configuration option.
   #
+  # #### Avoiding Numeric Slugs
+  #
+  # Purely numeric slugs like "123" can create ambiguity in Rails routing - they could
+  # be interpreted as either a friendly slug or a database ID. To prevent this, you can
+  # configure FriendlyId to treat numeric slugs as conflicts and add a UUID suffix:
+  #
+  #     class Product < ActiveRecord::Base
+  #       extend FriendlyId
+  #       friendly_id :sku, use: :slugged
+  #       friendly_id_config.treat_numeric_as_conflict = true
+  #     end
+  #
+  #     product = Product.create! sku: "123"
+  #     product.slug #=> "123-f9f3789a-daec-4156-af1d-fab81aa16ee5"
+  #
+  # This only affects purely numeric slugs. Alphanumeric slugs like "product-123"
+  # or "abc123" will work normally.
+  #
   # #### Providing Your Own Slug Processing Method
   #
   # You can override {FriendlyId::Slugged#normalize_friendly_id} in your model for
@@ -386,7 +404,7 @@ module FriendlyId
     # {FriendlyId::Configuration FriendlyId::Configuration}.
     module Configuration
       attr_writer :slug_column, :slug_limit, :sequence_separator
-      attr_accessor :slug_generator_class
+      attr_accessor :slug_generator_class, :treat_numeric_as_conflict
 
       # Makes FriendlyId use the slug column for querying.
       # @return String The slug column.

data/lib/friendly_id/version.rb

@@ -1,3 +1,3 @@
 module FriendlyId
-  VERSION = "5.5.1".freeze
+  VERSION = "5.7.0".freeze
 end

metadata

@@ -1,43 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: friendly_id
 version: !ruby/object:Gem::Version
-  version: 5.5.1
+  version: 5.7.0
 platform: ruby
 authors:
 - Norman Clarke
 - Philip Arndt
-autorequire:
 bindir: bin
-cert_chain:
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIEljCCAv6gAwIBAgIBATANBgkqhkiG9w0BAQsFADBRMREwDwYDVQQDDAhydWJ5
-  Z2VtczERMA8GCgmSJomT8ixkARkWAXAxFTATBgoJkiaJk/IsZAEZFgVhcm5kdDES
-  MBAGCgmSJomT8ixkARkWAmlvMB4XDTIyMTExNTIyMjQzMFoXDTIzMTExNTIyMjQz
-  MFowUTERMA8GA1UEAwwIcnVieWdlbXMxETAPBgoJkiaJk/IsZAEZFgFwMRUwEwYK
-  CZImiZPyLGQBGRYFYXJuZHQxEjAQBgoJkiaJk/IsZAEZFgJpbzCCAaIwDQYJKoZI
-  hvcNAQEBBQADggGPADCCAYoCggGBAMPq2bIEO+BmmBeuidSySK7xlL/LWBHzyDxw
-  EMgWsHqJMDZYCZI4WoWbSTSSLrp5zPXLWN0hB23u3dxFp4RVygTTZkc8k05mteab
-  fdREGgdcP+mY8/ASQSvb1VW6IM51Srgjy1SK0S5Qf3HAiQafFvRsxRkY0SWyth24
-  ne/7HG667vHQ1+t0VFl8twupJE9S8p2zgX3eZBl2yRNm/kE5reUsOLvmS58Iri/X
-  9tnz0SGkzrKkim9OIByq7XkFLL3oaIyfbBVgOWilM5pvxj/xNuRH7EIM6aE3q0UZ
-  xo7o9u9Iz2zApDEjejByPjxWAhLuP3v3bJyinRFE1rO47lEM/s6KM/6YooxvgYIN
-  miYYFRtTj9nmKEMv6+h1mZ1/ZwqStTTRh/T90T65dcgsoqRd0JNvpNRjFrYH5cuj
-  QZWMl/FE6AADm0GXa34ZiTQx3Wx2ctqJLFak8+imPwes90nCpiYmgaZpwBI+shjU
-  AddbPDNq+EoxPMWTh0Er3w76fywOWQIDAQABo3kwdzAJBgNVHRMEAjAAMAsGA1Ud
-  DwQEAwIEsDAdBgNVHQ4EFgQUxRJaTQZmtkN8FKUWVHKc2riND18wHgYDVR0RBBcw
-  FYETcnVieWdlbXNAcC5hcm5kdC5pbzAeBgNVHRIEFzAVgRNydWJ5Z2Vtc0BwLmFy
-  bmR0LmlvMA0GCSqGSIb3DQEBCwUAA4IBgQBSRGMkZ2dvJ0LSjFz+rIt3G3AZMbKD
-  tjaaQRuC9rOkrl3Rml6h9j7cHYiM0wkTjXneFNySc8jWmM/jKnxiiUfUK9r1XL4n
-  71tz39+MD2lIpLVVEQ69MIoUseppNUTCg0mNghSDYNwISMD/hoWwbJudBi56DbhE
-  xkulLbw8qtcEE+iilIKibe+eJF4platKScsOA7d1AuilR1/S245UzeqwwyI52/xK
-  dfoP928X9Tb/48+83lWUgAgCQOd6WdfCpgQ5H6R90lc8L7OfuDR/vgcmSOTsNVgG
-  1TC3b2FISS0p0qfZsiS7BXh+ARoBKLXsV1a7WR36X0dUpajvk+zzBGrFCdbW43Gx
-  wmJzIksYnf9Ktg8Ux+FLcRBGw4qEIyWvqmS0obB1Hke68rTg0uNTFcKXsNw33XF5
-  fw1cbj95g7OPe0feGK8+afXh/L38vx/hIIOGlUEZ+HaWL2Dki/7vRGvda8dfOpG5
-  bJfaoyKbVsrK+gGKFJv860zsO8lg6BGLsUw=
-  -----END CERTIFICATE-----
-date: 2023-11-12 00:00:00.000000000 Z
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -170,33 +141,14 @@ description: FriendlyId is the "Swiss Army bulldozer" of slugging and permalink
   as if they were numeric ids.
 email:
 - norman@njclarke.com
-- p@arndt.io
+- gems@p.arndt.io
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gemtest"
-- ".github/FUNDING.yml"
-- ".github/dependabot.yml"
-- ".github/stale.yml"
-- ".github/workflows/test.yml"
-- ".gitignore"
-- ".yardopts"
-- CONTRIBUTING.md
 - Changelog.md
-- Gemfile
 - MIT-LICENSE
 - README.md
-- Rakefile
-- UPGRADING.md
-- bench.rb
-- certs/parndt.pem
-- friendly_id.gemspec
-- gemfiles/Gemfile.rails-5.2.rb
-- gemfiles/Gemfile.rails-6.0.rb
-- gemfiles/Gemfile.rails-6.1.rb
-- gemfiles/Gemfile.rails-7.0.rb
-- guide.rb
 - lib/friendly_id.rb
 - lib/friendly_id/.gitattributes
 - lib/friendly_id/base.rb
@@ -218,32 +170,10 @@ files:
 - lib/friendly_id/slugged.rb
 - lib/friendly_id/version.rb
 - lib/generators/friendly_id_generator.rb
-- test/base_test.rb
-- test/benchmarks/finders.rb
-- test/benchmarks/object_utils.rb
-- test/candidates_test.rb
-- test/configuration_test.rb
-- test/core_test.rb
-- test/databases.yml
-- test/finders_test.rb
-- test/generator_test.rb
-- test/helper.rb
-- test/history_test.rb
-- test/numeric_slug_test.rb
-- test/object_utils_test.rb
-- test/reserved_test.rb
-- test/schema.rb
-- test/scoped_test.rb
-- test/sequentially_slugged_test.rb
-- test/shared.rb
-- test/simple_i18n_test.rb
-- test/slugged_test.rb
-- test/sti_test.rb
 homepage: https://github.com/norman/friendly_id
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -258,8 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: A comprehensive slugging and pretty-URL plugin.
 test_files: []

data/.github/FUNDING.yml

@@ -1 +0,0 @@
-github: parndt

data/.github/dependabot.yml

@@ -1,6 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"

data/.github/stale.yml

@@ -1,17 +0,0 @@
-# Number of days of inactivity before an issue becomes stale
-daysUntilStale: 84
-# Number of days of inactivity before a stale issue is closed
-daysUntilClose: 7
-# Issues with these labels will never be considered stale
-exemptLabels:
-  - pinned
-  - security
-# Label to use when marking an issue as stale
-staleLabel: stale
-# Comment to post when marking an issue as stale. Set to `false` to disable
-markComment: >
-  This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
-  for your contributions.
-# Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false

data/.github/workflows/test.yml

@@ -1,62 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - 'master'
-  pull_request:
-jobs:
-  test:
-    strategy:
-      matrix:
-        database: [ mysql, postgresql ]
-        gemfile: [ '7.0', '6.1', '6.0' ]
-        ruby: [ '2.6', '2.7', '3.0', '3.1', '3.2' ]
-        exclude:
-          - ruby: '2.6'
-            gemfile: '7.0'
-          - ruby: '3.2'
-            gemfile: '6.0'
-          - ruby: '3.2'
-            gemfile: '6.1'
-      fail-fast: false
-    runs-on: ubuntu-latest
-
-    env:
-      BUNDLE_GEMFILE: gemfiles/Gemfile.rails-${{ matrix.gemfile }}.rb
-      CI: true
-      COVERALLS: true
-      DB: ${{ matrix.database }}
-      MYSQL_PASSWORD: root
-      PGHOST: localhost
-      PGPASSWORD: runner
-      PGUSER: runner
-      RAILS_ENV: test
-
-    name: ${{ matrix.ruby }} ${{ matrix.database }} rails-${{ matrix.gemfile }}
-    steps:
-    - uses: actions/checkout@v3
-
-    - run: sudo apt-get update && sudo apt-get install libsqlite3-dev -y
-
-    - name: "Set up MySQL using VM's server"
-      if: ${{ env.DB == 'mysql' }}
-      run: |
-        sudo apt-get install libmysqlclient-dev -y
-        sudo systemctl start mysql.service
-
-    - name: "Set up PostgreSQL using VM's server"
-      if: ${{ env.DB == 'postgresql' }}
-      run: |
-        sudo apt-get install libpq-dev -y
-        sudo systemctl start postgresql.service
-        sudo -u postgres psql -c "CREATE USER runner WITH SUPERUSER PASSWORD 'runner'"
-        sudo -u postgres createdb runner
-
-    - uses: ruby/setup-ruby@v1
-      with:
-        bundler-cache: true
-        ruby-version: ${{ matrix.ruby }}
-
-    - run: bundle exec rake db:{create,up}
-    - run: bundle exec rake test

data/.gitignore

@@ -1,14 +0,0 @@
-Gemfile.lock
-doc
-docs
-pkg
-.DS_Store
-coverage
-.yardoc
-*.gem
-*.sqlite3
-*.rbc
-*.lock
-.rbx
-Guide.md
-.friendly_id

data/.yardopts

@@ -1,8 +0,0 @@
--e guide.rb
---files=Changelog.md,Guide.md
---tag guide
---hide-tag guide
---private
---protected
---exclude lib/friendly_id/migration
---markup=markdown

data/CONTRIBUTING.md

@@ -1,11 +0,0 @@
-# FriendlyId
-
-Please ask questions on [Stack
-Overflow](http://stackoverflow.com/questions/tagged/friendly-id) using the
-"friendly_id" or "friendly-id" tag. Prior to asking, search and see if your
-question has already been answered.
-
-Please only post issues in Github issues for actual bugs.
-
-I am asking people to do this because the same questions keep getting asked
-over and over and over again in the issues.

data/Gemfile

@@ -1,23 +0,0 @@
-source "https://rubygems.org"
-
-gemspec
-
-gem "standard"
-gem "rake"
-
-group :development, :test do
-  platforms :ruby do
-    gem "byebug"
-    gem "pry"
-  end
-
-  platforms :jruby do
-    gem "activerecord-jdbcsqlite3-adapter", ">= 1.3.0.beta2"
-    gem "kramdown"
-  end
-
-  platforms :ruby, :rbx do
-    gem "sqlite3"
-    gem "redcarpet"
-  end
-end

data/Rakefile

@@ -1,104 +0,0 @@
-require "rubygems"
-require "rake/testtask"
-
-task default: :test
-
-task :load_path do
-  %w[lib test].each do |path|
-    $LOAD_PATH.unshift(File.expand_path("../#{path}", __FILE__))
-  end
-end
-
-Rake::TestTask.new do |t|
-  t.libs << "test"
-  t.test_files = FileList["test/*_test.rb"]
-  t.verbose = true
-end
-
-desc "Remove temporary files"
-task :clean do
-  `rm -rf *.gem doc pkg coverage`
-  %x(rm -f `find . -name '*.rbc'`)
-end
-
-desc "Build the gem"
-task :gem do
-  `gem build friendly_id.gemspec`
-end
-
-desc "Build YARD documentation"
-task :yard do
-  puts `bundle exec yard`
-end
-
-desc "Run benchmarks"
-task bench: :load_path do
-  require File.expand_path("../bench", __FILE__)
-end
-
-desc "Run benchmarks on finders"
-task bench_finders: :load_path do
-  require File.expand_path("../test/benchmarks/finders", __FILE__)
-end
-
-desc "Run benchmarks on ObjectUtils"
-task bench_object_utils: :load_path do
-  require File.expand_path("../test/benchmarks/object_utils", __FILE__)
-end
-
-desc "Generate Guide.md"
-task :guide do
-  load File.expand_path("../guide.rb", __FILE__)
-end
-
-namespace :test do
-  desc "Run each test class in a separate process"
-  task :isolated do
-    dir = File.expand_path("../test", __FILE__)
-    Dir["#{dir}/*_test.rb"].each do |test|
-      puts "Running #{test}:"
-      puts `ruby -Ilib -Itest #{test}`
-    end
-  end
-end
-
-namespace :db do
-  desc "Create the database"
-  task create: :load_path do
-    require "helper"
-    driver = FriendlyId::Test::Database.driver
-    config = FriendlyId::Test::Database.config[driver]
-    commands = {
-      "mysql" => "mysql -h #{config["host"]} -P #{config["port"]} -u #{config["username"]} --password=#{config["password"]} -e 'create database #{config["database"]};' >/dev/null",
-      "postgres" => "psql -c 'create database #{config["database"]};' -U #{config["username"]} >/dev/null"
-    }
-    `#{commands[driver] || true}`
-  end
-
-  desc "Drop the database"
-  task drop: :load_path do
-    require "helper"
-    driver = FriendlyId::Test::Database.driver
-    config = FriendlyId::Test::Database.config[driver]
-    commands = {
-      "mysql" => "mysql -h #{config["host"]} -P #{config["port"]} -u #{config["username"]} --password=#{config["password"]} -e 'drop database #{config["database"]};' >/dev/null",
-      "postgres" => "psql -c 'drop database #{config["database"]};' -U #{config["username"]} >/dev/null"
-    }
-    `#{commands[driver] || true}`
-  end
-
-  desc "Set up the database schema"
-  task up: :load_path do
-    require "helper"
-    FriendlyId::Test::Schema.up
-  end
-
-  desc "Drop and recreate the database schema"
-  task reset: [:drop, :create]
-end
-
-task doc: :yard
-
-task :docs do
-  sh %(git checkout gh-pages && rake doc && git checkout @{-1})
-end

data/UPGRADING.md

@@ -1,115 +0,0 @@
-## Articles
-
-* [Migrating an ad-hoc URL slug system to FriendlyId](http://olivierlacan.com/posts/migrating-an-ad-hoc-url-slug-system-to-friendly-id/)
-* [Pretty URLs with FriendlyId](http://railscasts.com/episodes/314-pretty-urls-with-friendlyid)
-
-## Docs
-
-The most current docs from the master branch can always be found
-[here](http://norman.github.io/friendly_id).
-
-Docs for older versions are also available:
-
-* [5.0](http://norman.github.io/friendly_id/5.0/)
-* [4.0](http://norman.github.io/friendly_id/4.0/)
-* [3.3](http://norman.github.io/friendly_id/3.3/)
-* [2.3](http://norman.github.io/friendly_id/2.3/)
-
-## What Changed in Version 5.1
-
-5.1 is a bugfix release, but bumps the minor version because some applications may be dependent
-on the previously buggy behavior. The changes include:
-
-* Blank strings can no longer be used as slugs.
-* When the first slug candidate is rejected because it is reserved, additional candidates will
-  now be considered before marking the record as invalid.
-* The `:finders` module is now compatible with Rails 4.2.
-
-## What Changed in Version 5.0
-
-As of version 5.0, FriendlyId uses [semantic versioning](http://semver.org/). Therefore, as you might
-infer from the version number, 5.0 introduces changes incompatible with 4.0.
-
-The most important changes are:
-
-* Finders are no longer overridden by default. If you want to do friendly finds,
-  you must do `Model.friendly.find` rather than `Model.find`. You can however
-  restore FriendlyId 4-style finders by using the `:finders` addon:
-
-  ```ruby
-  friendly_id :foo, use: :slugged # you must do MyClass.friendly.find('bar')
-  # or...
-  friendly_id :foo, use: [:slugged, :finders] # you can now do MyClass.find('bar')
-  ```
-* A new "candidates" functionality which makes it easy to set up a list of
-  alternate slugs that can be used to uniquely distinguish records, rather than
-  appending a sequence. For example:
-
-  ```ruby
-  class Restaurant < ActiveRecord::Base
-    extend FriendlyId
-    friendly_id :slug_candidates, use: :slugged
-
-    # Try building a slug based on the following fields in
-    # increasing order of specificity.
-    def slug_candidates
-      [
-        :name,
-        [:name, :city],
-        [:name, :street, :city],
-        [:name, :street_number, :street, :city]
-      ]
-    end
-  end
-  ```
-* Now that candidates have been added, FriendlyId no longer uses a numeric
-  sequence to differentiate conflicting slug, but rather a UUID (e.g. something
-  like `2bc08962-b3dd-4f29-b2e6-244710c86106`). This makes the
-  codebase simpler and more reliable when running concurrently, at the expense
-  of uglier ids being generated when there are conflicts.
-* The default sequence separator has been changed from two dashes to one dash.
-* Slugs are no longer regenerated when a record is saved. If you want to regenerate
-  a slug, you must explicitly set the slug column to nil:
-
-  ```ruby
-  restaurant.friendly_id # joes-diner
-  restaurant.name = "The Plaza Diner"
-  restaurant.save!
-  restaurant.friendly_id # joes-diner
-  restaurant.slug = nil
-  restaurant.save!
-  restaurant.friendly_id # the-plaza-diner
-  ```
-
-  You can restore some of the old behavior by overriding the
-  `should_generate_new_friendly_id?` method.
-* The `friendly_id` Rails generator now generates an initializer showing you
-  how to do some common global configuration.
-* The Globalize plugin has moved to a [separate gem](https://github.com/norman/friendly_id-globalize) (currently in alpha).
-* The `:reserved` module no longer includes any default reserved words.
-  Previously it blocked "edit" and "new" everywhere. The default word list has
-  been moved to `config/initializers/friendly_id.rb` and now includes many more
-  words.
-* The `:history` and `:scoped` addons can now be used together.
-* Since it now requires Rails 4, FriendlyId also now requires Ruby 1.9.3 or
-  higher.
-
-## Upgrading from FriendlyId 4.0
-
-Run `rails generate friendly_id --skip-migration` and edit the initializer
-generated in `config/initializers/friendly_id.rb`. This file contains notes
-describing how to restore (or not) some of the defaults from FriendlyId 4.0.
-
-If you want to use the `:history` and `:scoped` addons together, you must add a
-`:scope` column to your friendly_id_slugs table and replace the unique index on
-`:slug` and `:sluggable_type` with a unique index on those two columns, plus
-the new `:scope` column.
-
-A migration like this should be sufficient:
-
-```ruby
-add_column   :friendly_id_slugs, :scope, :string
-remove_index :friendly_id_slugs, [:slug, :sluggable_type]
-add_index    :friendly_id_slugs, [:slug, :sluggable_type]
-add_index    :friendly_id_slugs, [:slug, :sluggable_type, :scope], unique: true
-```