Startscreen

 v1.0.51

Short overview of the main features can be found at the plugin page
Display changelog
  • Changes for v 1.0.51
  • New: "Hide on deep links" option to hide Start screen when url has parameters for deep linking.
  • Changes for v 1.0.5
  • New: "image resizing type" option for slider background. Available values Fill, Fit.
  • Improved: Increased delay maximum values in the settings.
  • Fixed: not working with ?vr parameter in the address bar.
  • Other little fixes

Plugin settings

Installation

Select Background

Color

Static image

Slider

Video

Start Screen size

Title Settings

Use Google fonts

Loading animation

Hide Start Screen


Installation

The Start Screen plugin is made available as a zipped file. Before installation, remove any previous version of the plugin. Unzip the downloaded package to any temporary folder. The plugin consists of two folders: alpo.start.screen-vX.X.X and alpo-startscreen-files

Copy the alpo.start.screen-vX.X.X folder to:

  • Windows: C:\Users\MyName\Documents\Kolor\PanotourPro 2\plugins
  • Mac: /Users/MyName/Documents/Kolor/PanotourPro 2/plugins
  • Linux: /home/$USER/Documents/Kolor/PanotourPro 2/plugins
  • Copy the alpo-startscreen-files folder to the tools folder in your user directory. To browse your user directory in Panotour Pro, go to Edit > Open User Directory. Open your file explorer. The filepath will look like this:

  • C:\Users\username\Documents\Kolor\PanotourPro 2\tools
  • You will need to restart Panotour Pro to see the plugin!
  • To uninstall the plugin, delete the alpo.start.screen-vX.X.X directory and all of its contents.

    Select Background

    Select main content do display in the startscreen.

    Color
    • Choose the background color of the start screen. If this setting is selected, the startscreen will be filled with the chosen color. If another background setting is selected (image, slider, video), this color will be used as the background of the main content.
    Static image
    • Choose an image to be displayed as the background of the start screen. This image retains its size and will not be resized for different screens.
    • Choose file
    • Repeat
    • Image is repeated vertically and horizontally.
    Slider Add slides
    • Add images and videos for the slides. If video is added, then the play button will be displayed over the appropriate image slide. Copy the link to the video using the "Share" option on the Youtube, for Vimeo use link of the video page. The image in slide is resizable for different screens. If add one slide, it can be used as the image background with resizing options, instead of "Static image", if needed.
    Slider settings
    • Transition type
    • Transition type for slides: Fade or Move
    • Transition speed
    • Slider transition speed, in ms
    • Behavior (Transition type: Move)
    • Choose slider behavior after the last slide. Loop or Rewind to the first slide. For "Fade" type, slider behavior is always Loop.
    • Use preloader for slides
    • Enables spinning preloader for slides.
    • Autoplay slides
    • Enables slides autoplay.
    • Randomize slides
    • Display slides in a random order. If disabled, slides will be displayed in the order as they added in the plugin.
    • Arrows navigation
    • Display direction arrows navigation over slides.
    • Bullets navigation
    • Display bullets navigation over slides.
    • Image resizing type
    • Set type of resizing for slider images. Available values Fill, Fit.
    • Fill
    • Image size calculated to keep proportions and fill startscreen area. Image size can be larger than the size of the startscreen and therefore some parts of the image will not be visible.
    • Fit
    • Image size calculated to keep proportions and fit image inside the startscreen.
    • Slider controls skin
    • Select skin for arrows and bullet navigations.
    Video
    • HTML5 ONLY. Use video file to display as a background. Enables settings sections Video files and Video settings.
      Note about mobiles: Some mobile platforms complicate the use of video background. Start screen will automatically detect such mobiles and display the poster image instead of the video.
    Video files
    • Video file should be converted to three formats (mp4, webm, ogg), to support different systems and browsers. There are online video conversion tools or free software like Miro video converter.
    • Poster
    • Poster image that will be displayed before starting or initialising the video. Image should be the same size in pixels as the video. It's a good idea to use first frame of the video as a poster image.
    Video settings
    • Additional setting for video startscreen.
    • Autoplay
    • Video will start playing immediately after loading the web-page. Important notice! It's a good practice to mute sound if you are enabling autoplay. Most mobile platforms will refuse to autoplay video, in that case the poster image will be displayed.
    • Loop
    • Play repeatedly, to make the video start again after it reaches the end. As an advice, do not use Loop with too short video.
    • Muted
    • If enabled, the audio output of the video will be muted. Recommended for use in combination with autoplay. You can display unmute button using settings below.
    • Resizable
    • If enabled, the video and the poster image will be scaled accordingly to the browser window, keeping the proportions. In some cases it will be more look like the video element on the page, than background. To fill the bowser window with a video regardless of the size of the device, you should disable this settings.
    • Over-scale
    • Used in combination with "Resizable" setting, to prevent scaling the video more than original size on large screens.
    • Display video controls
    • Enables default settings for video controls and displays Video controls settings section.
    Video controls settings
    • Click to pause / play
    • Enables to pause / play video by clicking on the video.
    • Play / pause button
    • Displays play / pause button. Position settings are set below.
    • Mute / Unmute button
    • Displays Mute / Unmute button. Position settings are set below.
    • Buttons settings
    • Section to set position and color of the control buttons.
    • Position horizontally
    • Position control buttons horizontally. Available settings: Left, Right.
    • Position vertically
    • Position control buttons vertically. Available settings: Top, Bottom.
    • Padding
    • Space between the control buttons and the edge of the background element.
    • Main color
    • Color and opacity of the control buttons. Opacity will be used also for hover color.
    • Hover color
    • Hover color of the control buttons. To change color on mouse-over.
    • Progress bar
    • Displays video progress bar. Recommended for use in combination with Event setting "Video ended", to give the user an idea when the video will be completed. It also displays Progress bar settings section.
    Progress bar settings
    • Settings section to customize progress bar. Progress bar width is always 100% of the video element.
    • Position
    • Available settings: Top, Bottom.
    • Height
    • Height of the progress bar (in pixel).
    • Background color
    • Background color of the progress bar. Opacity will be ignored.
    • Progress color
    • Color of the progress element. Opacity will be ignored.

    Start Screen size

    Sets size and position of the startscreen.

    Full
    • Sets size of the startscreen to cover whole virtual tour container.
    Set
    • Select this option to set custom size and position for startscreen. This displays additional settings section.
    • Centering
    • Quick positioning, if you need to center startscreen. If enabled, the appropriate X-offset and Y-offset position settings will be ignored.
    • Set size
    • Width / Height
    • Start Screen width and height settings. Available units: pixel, percent.
    • Offset
    • X-Offset / Y-Offset
    • Shift Startscreen container horizontally / Vertically. Available units: pixel, percent.

    Title Settings

    Title settings section.

    Title
    • Enter title content. Leave this field blank if you do not want to use a title for the Start Screen. You can use <br> html tag to break the title line.
    Title color
    • Title text color. Opacity will be ignored.
    Display background for title. Title background settings.
    • Settings to customize title background.
    • Title background color
    • Choose color and opacity for title background.
    • Title x/y-padding
    • Set size of the background around the title.
    Font settings
    • Font size and line height settings section in vw. vw - represent percentages of the browser viewport width. 1vw = 1% of viewport width. You can set floating-point number. Default is 6.
    • Font size
    • Sets font size.
    • Line height
    • Sets line height. Can be useful for multi-line title (use <br> html tag to break the title line).
    Title Position
    • Settings to customize position of the title.
    • Title horizontal position
    • Horizontal positioning of the title. Available options: Left, Right. The offset value for horizontal positioning can be set in pixel or percent.
    • Title vertical position
    • Vertical positioning of the title. Available options: Top, Bottom. The offset value for vertical positioning can be set in pixel or percent.
    • Set center as edge
    • Possible to enable separately for horizontal and vertical positioning. Enable to calculate offset value from the edge of the background element to the center of title. Useful if you need to position element at the center of the screen, set values to 50% and enable this option for both horizontal and vertical positioning.
    Use Google fonts Fonts settings
    • Settings to integrate font from the Google Fonts directory.
    • Integrate
    • Integrating code. When you have chosen your font in the Google Fonts directory, click the "Quick-use" icon to open the font settings page. Then scroll down to Section 4 "Integrate the fonts into your CSS" and copy the whole line of the presented code. And paste this code to the plugin field.
    • Select font

      Select font

      Copy CSS rules

      Copy CSS rules

      Paste into the plugin

      Paste into the plugin

    • Font name
    • Copy and paste the font name from the previous field.
    • paste the font name

      Paste the font name

    • Font weight
    • Specifies the weight or boldness of the font. However, some fonts are not available in all weights. You should check available weights and select one in the section 1 "Choose the styles you want" in the font Quick Use page.
    • Font style
    • Set text style as normal or italic. However, some fonts are not available in italic style. You should check available styles and select one in the section 1 "Choose the styles you want" in the font Quick Use page.

    Loading animation

    Section to set-up loading indicator, using css or image animation that will be displayed while the virtual tour is initializing or loading.

    Use loading animation
    • Enables default settings for loading animation and displays additional settings sections.
    Choose animation type CSS animation (Spinkit)
    • A collection of loading indicators by Tobias Ahlin will be used.
    • Select animation
    • Select one from available loading indicators.
    • Main color
    • Sets color for chosen loading indicator. Opacity setting will be ignored.
    Image
    • Choose the animated .gif or just static image. Note: File name should begin with an alphabetic character. Here is a web service that allow you to quickly customize your loading animation - preloaders.net.
    • Width / Height
    • Sets width and height for image, if set 0, then original size will be used.
    Loading animation position
    • Settings to position loading indicator.
    • Set position relatively to the title
    • Enable to calculate position from the edge of the title element and not from the edge of the startscreen.
    • Vertical position
    • Horizontal position
    • Horizontal positioning of the loading indicator. Available options: Left, Right. The offset value for horizontal positioning can be set in pixel or percent.
    • Vertical position
    • Vertical positioning of the loading indicator. Available options: Top, Bottom. The offset value for Vertical positioning can be set in pixel or percent.
    • Set center as edge
    • Possible to enable separately for horizontal and vertical positioning. Enable to calculate offset value from the edge of the background element to the center of title. Useful if you need to position element at the center of the screen, set values to 50% and enable this option for both horizontal and vertical positioning.
    • Percent of title width / height
    • Possible to enable separately for width and height. Enable to calculate position in percent using title width / height as 100% and not the startscreen width / height. It can be useful with combination of "Set position relatively to the title" option.

    Hide Start Screen

    Settings for hiding the start screen.

    Hide automatically and display tour
    • If selected, the start screen will be hidden when the virtual tour is initialized or loaded, depending on your Event settings. Once the start screen is hidden, the tour will be displayed.
    Show button to display tour
    • If selected, the start screen will not be closed automatically. Instead, a button will appear when the virtual tour is initialized or loaded, depending on your Event settings, that when clicked, hides the start screen and displays the tour.
    • Choose file
    • Choose the file for the Start tour button and set its width/height in px or percentage. Set 0 to use original image size.
    Event
    • Select the event that will hide the startscreen. Available events: Tour is initialized; Tour is loaded, Specify time, Video ended.
    • Tour is initialized
    • The tour is start loading
    • Tour is loaded
    • First pano is fully loaded
    • Specify time
    • After specified time
    • Delay
    • Delay time (in ms) after which hide startscreen.
    • Video ended
    • If Video background selected, hide startscreen when the video is played completly.
    Clickable Title
    • If enabled, then the start screen can be hidden by clicking on the title.
    Hide on deep links
    • Enable, to hide start screen if url has deep linking paramrter (for example: ?s=pano41).
    Additional actions when closing the Start Screen
    • Add actions
    • If enabled, displays actions settings.
    • Choose actions
    • Standard Panotour choose actions option.
    • Delay actions
    • Option to set time (in ms) to wait after hiding the startscreen before calling the selected action(s).


    Thank you so much for purchasing the plugin for Panotour Pro.
    If you have any questions relating to this plugin, I'll try my hardest to assist you.

    Alexander Popov


    Top