https://github.com/codevise/pageflow-panorama

Page type for displaying 360 degree panoramas.
https://github.com/codevise/pageflow-panorama

Last synced: 3 months ago
JSON representation

Page type for displaying 360 degree panoramas.

• Host: GitHub
• URL: https://github.com/codevise/pageflow-panorama
• Owner: codevise
• Created: 2014-07-22T09:28:37.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2024-01-15T05:53:02.000Z (over 2 years ago)
• Last Synced: 2025-07-28T07:37:29.479Z (11 months ago)
• Language: Ruby
• Size: 125 KB
• Stars: 1
• Watchers: 7
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

          
# Pageflow Panorama

[![Gem Version](https://badge.fury.io/rb/pageflow-panorama.svg)](http://badge.fury.io/rb/pageflow-panorama)

[![Build Status](https://github.com/codevise/pageflow-panorama/workflows/tests/badge.svg)](https://github.com/codevise/pageflow-panorama/actions)

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](https://github.com/codevise/pageflow/wiki/Troubleshooting)

wiki page in the

[Pageflow repository](https://github.com/codevise/pageflow). If that

doesn't help, consider

[filing an issue](https://github.com/codevise/pageflow-panorama/issues).

## Contributing Locales

Edit the translations directly on the

[pageflow-panorama](http://www.localeapp.com/projects/public?search=tf/pageflow-panorama)

locale project.