claromentis/slider

Homepage slider


Keywords
slider, claromentis
License
ClArtistic

Documentation

Homepage Slider

The claromentis multi-style homepage slider.

Vertical view:

Horizontal view:

Apps view:

Install or initial upgrade from a Claromentis 7.1 system

  • Copy the content of this repository into /intranet/slider of the destination system
  • On the command line on the target system run phing -Dapp=slider install

Upgrade

  • On the command line on the target system run phing -Dapp=slider upgrade

To embed within a publish page, use:

    <script type="text/javascript">
        <!--
        var smart_slider = {}
        smart_slider.name="slider"
        smart_slider.key="yourSlider_keyname"
        smart_slider.width="735" // Optional
        smart_slider.height="245" // Optional
        smart_slider.speed="5" // Optional
        //-->
    </script>
    <script type="text/javascript" src="/intranet/slider/js/smart_slider.js"></script>

For home page component:

    <component class="SliderComponent" key="yourSlider_keyname">

Home page component attributes:

Attribute Required Description
key Yes The key of the slider to use for this component
template No Override for the default html template
speed No How frequently to change slides, in seconds

Slider links now support parameter substitution where a placeholder is replaced with the correct value when clicked by a user. These placeholders can include most user profile fields (e.g. username, firstname, surname, etc) as well as custom metadata (e.g. [m]usr_phone). Password and password hash are not permitted.

To utilise, simple place the field/metadata name inside of double curly brackets.

Examples:

Change log

v3.5.2 -- 07 Jul 2015

  • Fixed slider smart object.
  • Implemented customisable slider speed.

v3.5.1 -- 15 Jun 2015

  • Bugfix: Re-ordering slides was not compatible with load-balancing.
  • Added BBCode processing for horizontal and vertical sliders.

v3.5 -- 06 May 2015

  • New: configurable number of slides to display for horizontal slider
  • Increased the length of slide link from 256 to 1024 characters

v3.4 -- 08 January 2015

  • New: CDN (load balancing) compatibility for slider images.
  • Requires Claromentis 7.3+.
  • Fixed bug regarding fields/metadata in slide URLs.
  • Added in ability to pass custom html templates.

v3.3 -- 28 March 2014

  • Added placeholder substitution for slider links.

v3.2 -- 05 February 2014

  • Fully 7.2/phing compatible.

v3.1.4 and v3.1.5 -- 27 January 2014

  • 7.2 switch Upgraded install/upgrade scripts to new system.
  • For Claromentis 7.1 systems Use v3.1.3.

v3.1.2 -- 30 August 2013

  • Bugfix: MSSQL compatibility: sql_up scripts had an issue.

v3.1.1 -- 28 August 2013

  • Bugfix: Smart object: The app slider was not possible to see via smart objects.

v3.1 -- 31 July 2013

  • Title visibility: Can now select if title, tooltip, both or neither should be shown per slide.
  • HTML link target: Field per slide to open links in same window, parent window, new window/tab or a specific one.
  • Colour picker: Now uses KolorPicker component.
  • Fix: Alternate protocol: Only kclient:// for now but can add them by request.
  • Fix: URL validation: URLs are now validated.

v3 -- 21 June 2013

  • App Slider: New style of slider that allows icons to links.
  • Multiple Sliders: JavaScript update to allow multiple sliders on the same page.
  • Permissions: All slides now use the permissions system to allow custom sliders per role/person.
  • Tooltips: For title-less slides.
  • Localisation: Slide titles, nav titles, nav descriptions and tooltip can use the "@{blog.common.blog|Default text}" format of localisation.
  • Restarted the old change log :-)