Each slider has it own settings that may or may not apply to the slides within the slider:
Additionally, each slide has its own handle and can be assigned it's own transition effect, transition and view duration, and can specify which slide is should be the next slide or the previous slide.
tcSlider supports simple next/previous links via the edit options. In many cases, however, you may not want to use these. A far more powerful way to control to tcSlider is through custom links (HTML '<a>' tags). By using custom links you can specify the slide and slide transition to use, which means your slider need not operate as a simple linear slideshow.
tcSlider will automatically handle links using the following criteria:
The tcSlider can use the output of Concrete5 blocks for the content of slides. Content slides, for example, are actually essentially just instances of the Concrete5 HTML block. Many other blocks may be use, though, not all will work with tcSlider. You may need to experiment with different blocks to see if they will work with tcSlider.
Some blocks will not work with tcSlider. Other blocks may require custom PHP code to be written for them to work properly. The core Form block, for example, will display properly with tcSlider but because it posts back to the page the slider is on when the a form is submitted there is some extra work that need to be done in order to connect the form post to the slide that contains the form block.
Block output may be loaded once when the page is first loaded or dynamically each time before a slide is displayed. Choose 'Yes' for 'Use Ajax for Blocks' if you want the block content reloaded each time the slide is displayed.
Except for content slides, to use a block with tcSlider you must first follow the steps below. Depending on which version of concrete5 you are using these steps will be different:
If you are using concrete5 version 5.3.x - 5.4.x follow these steps:
If you are using concrete5 version 5.5.x follow these steps:
If you upgrade a site from concrete5 version 5.4.x to 5.5.x and you are using tcSlider with block slides, you need to be aware that the Global Scrapbook (and other scrapbooks) will no longer be editable from the concrete5 dashboard. Your tcSlider blocks will continue to work correctly so long as you don't edit them. If you need to edit a tcSlide block, however, you will need to follow the steps above for concrete5.5.x. You will have to create a new tcSlider stack, add blocks to the stack, and name each block in the stack.
In much the same way that Concrete5 blocks can used as the source for slides, URLs may also be used to obtain slide content. When editing a tcSlider click the 'Add URL' button to add an URL-based slide then type in the URL that you want to use. The URL may be fully qualified or may be a relative path.
tcSlider passes two POST argument to the slide URL that can be used to allow an URL to generate different content for different slides. 'slider' contains the slider handle, and 'slide' contains the slide handle.
The slider 'Use Ajax for URLs' option operates like the similar option for blocks. If enabled, tcSlider will make an Ajax request to the URL to dynamically obtain new content each time the slide is displayed. If disabled, tcSlider will use Curl to fetch the content when the page loads; note that your installation of PHP must have Curl enabled in order for this to work.
As a security precaution most browsers do not allow Ajax requests between domains. So, if you intend to use an external URL for a slide, make sure you do not enable Ajax.
Why can't I use the Concrete5 sitemap to choose a page for slide URLs?
Slides are not complete pages, they are just chunks of HTML that become part of the page when embedded in a slider. If you want to embed a complete page within the slider you can use something like the iframe block.
Can you provide an example of using a URL for a slide?
Yes, tcSlider includes an very simple sample URL. Take a look at the following file included in the add-on package:
You can use this sample script in a tcSlider by using the URL:
To add your own slide URLs you would add a similar script to your site's top-level tools directory (<concrete5-install-dir>/tools) and reference it with an URL like:
I just installed tcSlider and now my concrete5 edit bar is gone!