Low commit activity in last 3 years
A long-lived project that still receives updates
Pagetype for iframe embedded 360° panoramas
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 1.0, < 3
>= 15.0, < 18
~> 12.0
~> 1.0

Runtime

~> 1.17
>= 15.0, < 18
~> 1.1
 Project Readme

Pageflow Panorama

Gem Version Build Status

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.