webflow_sync 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14705897f82379cd4aa7b11ceda57374b6066d26b96344318ec4089048c377bb
-  data.tar.gz: b17539c21bc34e339ddd12843831fcf61294876d6bc136d6ac7abbced15826fb
+  metadata.gz: 36b6c5dc80e752a95692afe908be134cdefd6193e0ed712c7a6d41440bb679e0
+  data.tar.gz: 5bd56794f4d0f09634a776b18ca613844b149afaf99cbbb841fe6294ae5cc67a
 SHA512:
-  metadata.gz: fb9e2b651a04fd77506a3c869c5b33716131fa765ad413ac6180ca5c1805e141bb6b3b7310c4a8dbdc3f6e71782e7a1bf1a62bdbb78b8c224d8ef3c0669c3e74
-  data.tar.gz: e6bcaf360ecf06bbaf08f78664715dceea5f10a3f529912f9d445aaa39fbe769b4c0fc4c11c583d5e6977e5e3885dc90c17b3a1c8f17c404b585140a3de57dc0
+  metadata.gz: 83fe81d28e2aec28ef31bee07956f8a105b368053f60dbcff1e668ae853671e708e543db1444aad37571117562ac7c6412913600c1da0d35d80851d5438a827c
+  data.tar.gz: 9e40ae99fa67b4d6ae787900e288009f2d7bc3c6633908e36f13efec62df3b676ec23ddcf0710cbd82a80beb5a573bf13da69c2d13c8f49c9db57686f8d60428

data/README.md

@@ -28,6 +28,14 @@ bundle exec rails generate webflow_sync:install
 
 ## Usage
 
+### Generate and set WebFlow API token
+
+Run API token Rails generator and follow instructions:
+
+```bash
+bundle exec rails generate webflow_sync:api_token_flow
+```
+
 ### Add WebflowSync to models
 
 For each model that you want to sync to WebFlow, you need to run the collection generator:
@@ -53,6 +61,79 @@ For example, for `Article` model:
 
 Your WebFlow collection `slug` should be `"articles"`.
 
+### Set `webflow_site_id`
+
+There are couple of ways how you can set the `webflow_site_id` to be used.
+
+#### Set `webflow_site_id` through configuration
+
+In `config/initializers/webflow_sync.rb` you can specify `webflow_site_id`:
+
+```ruby
+WebflowSync.configure do |config|
+  config.webflow_site_id = ENV.fetch('WEBFLOW_SITE_ID')
+end
+```
+
+#### Set `webflow_site_id` for each model individually
+
+You can set `webflow_site_id` per model, or even per record.
+
+To do this, override the `#webflow_site_id` method provided by `WebflowSync::ItemSync` in your ActiveRecord model.
+
+For example, you could have `Site` model in your codebase:
+
+```ruby
+# app/models/site.rb
+class Site < ApplicationRecord
+  has_many :articles
+end
+
+# app/models/article.rb
+class Article < ApplicationRecord
+  include WebflowSync::ItemSync
+
+  belongs_to :site
+
+  def webflow_site_id
+    self.site.webflow_site_id
+  end
+end
+```
+
+### Customize fields to synchronize
+
+By default, WebflowSync calls `#as_webflow_json` on a record to get the fields that it needs to push to WebFlow. `#as_webflow_json` simply calls `#as_json` in its default implementation. To change this behavior, you can override `#as_json` in your model:
+
+```ruby
+# app/models/article.rb
+class Article < ApplicationRecord
+  include WebflowSync::ItemSync
+
+  def as_json
+    {
+      title: self.title.capitalize,
+      slug: self.title.parameterize,
+      published_at: self.created_at,
+      image: self.image_url
+    }
+  end
+end
+```
+
+Or if you already use `#as_json` for some other use-case and cannot modify it, you can also override `#as_webflow_json` method. Here's the default `#as_webflow_json` implementation (you don't need to add this to your model):
+
+```ruby
+# app/models/article.rb
+class Article < ApplicationRecord
+  include WebflowSync::ItemSync
+  
+  def as_webflow_json
+    self.as_json
+  end
+end
+```
+
 ### Run the initial sync
 
 After setting up which models you want to sync to WebFlow, you can run the initial sync for each of the models:

data/Rakefile

@@ -10,3 +10,6 @@ load 'rails/tasks/statistics.rake'
 require 'bundler/gem_tasks'
 
 require 'stylecheck/rake_tasks' unless Rails.env.production?
+
+load 'rspec/rails/tasks/rspec.rake'
+task default: :spec

data/app/services/webflow_sync/api.rb

@@ -10,22 +10,31 @@ module WebflowSync
 
     def create_item(record, collection_slug)
       collection = find_webflow_collection(collection_slug)
-      response = client.create_item(collection['_id'], record.as_webflow_json, live: true)
+      response = client.create_item(
+        collection['_id'],
+        record.as_webflow_json.reverse_merge(_archived: false, _draft: false), live: true
+      )
 
       record.update!(webflow_item_id: response['_id'])
+      puts "Created #{record.inspect} in #{collection_slug}"
+      response
     end
 
     def update_item(record, collection_slug)
       collection = find_webflow_collection(collection_slug)
-      client.update_item(
+      response = client.update_item(
         { '_cid' => collection['_id'], '_id' => record.webflow_item_id },
-        record.as_webflow_json, live: true
+        record.as_webflow_json.reverse_merge(_archived: false, _draft: false), live: true
       )
+      puts "Updated #{record.inspect} in #{collection_slug}"
+      response
     end
 
     def delete_item(collection_slug, webflow_item_id)
       collection = find_webflow_collection(collection_slug)
-      client.delete_item({ '_cid' => collection['_id'], '_id' => webflow_item_id })
+      response = client.delete_item({ '_cid' => collection['_id'], '_id' => webflow_item_id })
+      puts "Deleted #{webflow_item_id} from #{collection_slug}"
+      response
     end
 
     private
@@ -39,10 +48,10 @@ module WebflowSync
       end
 
       def find_webflow_collection(collection_slug)
-        result = collections.find { |collection| collection['slug'] == collection_slug }
-        raise "Cannot find collection #{collection_slug} for Webflow site #{site_id}" unless result
+        response = collections.find { |collection| collection['slug'] == collection_slug }
+        raise "Cannot find collection #{collection_slug} for Webflow site #{site_id}" unless response
 
-        result
+        response
       end
   end
 end

data/lib/generators/webflow_sync/api_token_flow_generator.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'rails/generators/active_record'
+
+module WebflowSync
+  module Generators
+    class ApiTokenFlowGenerator < Rails::Generators::Base
+      desc 'Generates Omniauth flow for authenticating WebFlow application to get WebFlow API token'
+
+      source_root File.expand_path('templates/api_token', __dir__)
+
+      def generate
+        gem 'omniauth-webflow'
+        run 'bundle install'
+        template 'webflow_callback_controller.rb.erb', 'app/controllers/webflow_callback_controller.rb'
+        template 'omniauth_webflow.rb.erb', 'config/initializers/omniauth_webflow.rb'
+        route "post '/auth/webflow/callback', to: 'webflow_callback#index'"
+        route "get '/auth/webflow/callback', to: 'webflow_callback#index'"
+
+        puts <<~END_OF_INSTRUCTIONS.indent(4)
+
+
+          We've generated all the files needed to successfully authenticate
+          with WebFlow to get API token.
+          There are couple of steps left to get the token:
+
+               1. Download ngrok: https://ngrok.com/download
+               2. Run `ngrok http 3000`
+               3. Copy the URL that ngrok gives you (something like: https://dd7cc807bf91.ngrok.io)
+               4. Go to: https://webflow.com/dashboard/account/integrations
+               5. Register New Application
+               6. In "Redirect URI" put: https://dd7cc807bf91.ngrok.io/auth/webflow/callback
+               7. Save
+               8. Copy client ID and client secret to ENV variables or add
+                  them directly in config/initializers/omniauth_webflow.rb
+               9. Start rails server locally
+              10. Go to https://dd7cc807bf91.ngrok.io/auth/webflow
+              11. Finally authenticate, beware which permissions to give
+                  (some are "allow access", some are "restrict access", it's confusing)
+              12. Copy the rendered API token and put it in ENV.fetch('WEBFLOW_API_TOKEN')
+              13. After you've got the API token, you probably don't need
+                  the Omniauth WebFlow code so you can remove the code that this
+                  generator created from your codebase.
+                  It is also a security issue to leave the Omniauth endpoint in your
+                  codebase, that has the ability to generate API tokens for your WebFlow
+                  account!!!
+
+          Easy.
+
+
+        END_OF_INSTRUCTIONS
+      end
+    end
+  end
+end

data/lib/generators/webflow_sync/templates/api_token/omniauth_webflow.rb.erb

@@ -0,0 +1,3 @@
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :webflow, ENV.fetch('WEBFLOW_CLIENT_ID'), ENV.fetch('WEBFLOW_CLIENT_SECRET')
+end

data/lib/generators/webflow_sync/templates/api_token/webflow_callback_controller.rb.erb

@@ -0,0 +1,8 @@
+class WebflowCallbackController < ApplicationController
+  skip_before_action :verify_authenticity_token, only: :index
+
+  # Go to /auth/webflow to start oauth flow
+  def index
+    render plain: request.env['omniauth.auth'].dig('credentials', 'token')
+  end
+end

data/lib/generators/webflow_sync/templates/webflow_sync.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 WebflowSync.configure do |config|
+  # config.api_token = ENV.fetch('WEBFLOW_API_TOKEN')
   # config.skip_webflow_sync = Rails.env.test? # default
   config.webflow_site_id = ENV.fetch('WEBFLOW_SITE_ID')
 end

data/lib/webflow_sync/configuration.rb

@@ -6,7 +6,10 @@ module WebflowSync
 
     def configure
       self.configuration ||= Configuration.new
-      yield(configuration)
+      yield(self.configuration)
+
+      self.configuration.api_token ||= ENV.fetch('WEBFLOW_API_TOKEN')
+      self.configuration.skip_webflow_sync ||= Rails.env.test?
     end
 
     private
@@ -15,10 +18,10 @@ module WebflowSync
   end
 
   class Configuration
-    attr_accessor :skip_webflow_sync, :webflow_site_id
+    attr_accessor :api_token, :skip_webflow_sync, :webflow_site_id
 
-    def initialize
-      @skip_webflow_sync = Rails.env.test?
+    def api_token=(value)
+      @api_token = Webflow.config.api_token = value
     end
   end
 end

data/lib/webflow_sync/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WebflowSync
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: webflow_sync
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Viktor
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-29 00:00:00.000000000 Z
+date: 2021-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -139,11 +139,14 @@ files:
 - app/models/concerns/webflow_sync/callbacks.rb
 - app/models/concerns/webflow_sync/item_sync.rb
 - app/services/webflow_sync/api.rb
+- lib/generators/webflow_sync/api_token_flow_generator.rb
 - lib/generators/webflow_sync/collection_generator.rb
 - lib/generators/webflow_sync/install_generator.rb
+- lib/generators/webflow_sync/templates/api_token/omniauth_webflow.rb.erb
+- lib/generators/webflow_sync/templates/api_token/webflow_callback_controller.rb.erb
 - lib/generators/webflow_sync/templates/migration.rb.erb
 - lib/generators/webflow_sync/templates/webflow_sync.rb
-- lib/tasks/webflow_sync_tasks.rake
+- lib/tasks/webflow_sync.rake
 - lib/webflow_sync.rb
 - lib/webflow_sync/configuration.rb
 - lib/webflow_sync/engine.rb