Pageflow Panorama
Page type showing 360° panoramas in embedded iframes. Currently supported are panoramas by palmsfilm.com, panogate.com and KRPano via upload in the editor.
Installation
Add pageflow-panorama to your application's Gemfile:
# Gemfile
gem 'pageflow-panorama'
and run bundle install
.
Register the page type:
# config/initializers/pageflow.rb
Pageflow.configure do |config|
config.page_types.register(Pageflow::Panorama.page_type)
end
Include javascripts and stylesheets:
# app/assets/javascripts/pageflow/application.js
//= require pageflow/panorama
# app/assets/javascripts/pageflow/editor.js
//= require pageflow/panorama/editor
# app/assets/stylesheets/pageflow/application.scss
@import "pageflow/panorama";
# app/assets/stylesheets/pageflow/editor.scss
@import "pageflow/panorama/editor";
# app/assets/stylesheets/pageflow/themes/default.scss
@import "pageflow/panorama/themes/default";
Install and run migrations:
$ rake pageflow_panorama:install:migrations
$ rake db:migrate
Create Proxies for the Panorama Providers:
To circumvent the same-origin policy, a proxy from the domain that serves pageflow to the domain of the panorma-providers has to be configured.
Example for Nginx:
Copy config/pageflow-panorama-proxies.conf.example
to your Nginx config
directory, for example /etc/nginx/pageflow-panorama-proxies.conf
and include it in you pageflow config file:
include /etc/nginx/pageflow-panorama-proxies.conf
Configure the Supported Panorama Providers
If you support both palmfilms and panogate just copy
config/pageflow_panorama.rb.example
to config/initializers/pageflow_panorama.rb
in your app. This sets the base_path
to correspond with the proxy configuration above.
Restart the application server.
Troubleshooting
If you run into problems while installing the page type, please also refer to the Troubleshooting wiki page in the Pageflow repository. If that doesn't help, consider filing an issue.
Contributing Locales
Edit the translations directly on the pageflow-panorama locale project.