內容簡介
Agnosia Bootstrap Carousel外掛將用帶有屬性type="carousel"的短碼來顯示基於所選圖片及其標題和描述的Bootstrap Carousel。
這個外掛假設你的佈景主題包含必要的Bootstrap javascript和CSS文件以正確顯示旋轉木馬，或者你已經自己包含了這些文件。如果它們不存在，該旋轉木馬將無法正常工作，並且你只能獲得它的基本HTML。
基本範例：
必填屬性：
type：它必須是type="carousel"。
ids：你必須提供對應附件的ID列表，如ids="1,2,3"。
否則，將處理默認的短碼函數而不是此外掛的函數。
可選屬性：
name：任何名稱。 字符串將被清理，以便用作HTML ID。當您想在同一頁面上有多個旋轉木馬時建議使用。默認值：agnosia-bootstrap-carousel。示例：
indicators：指標位置。 可接受的值：before-inner，after-inner，after-control，false（隱藏指標）。 預設值：before-inner。 示例：
width：旋轉木馬容器寬度，以px或%為單位。 預設值：未設置。 示例：
height：旋轉木馬項目高度，以px或%為單位。 預設值：未設置。 示例：
titletag：為圖像標題定義HTML標籤。 預設值：h4。 示例：
wpautop：自動格式文本。 預設值：true。 示例：
title：顯示或隱藏圖像標題。將其設為false即可隱藏。 預設值：true。 示例：
text：顯示或隱藏圖像文本。將其設為false即可隱藏。 預設值：true。 示例：
containerclass：旋轉木馬容器的額外類別。 預設值：未設置。 示例：
itemclass：旋轉木馬項目的額外類別。 預設值：未設置。 示例：
captionclass：項目標題的額外類別。 預設值：未設置。 示例：
control：控制箭頭顯示。可接受的值：true（顯示），false（隱藏）。 預設值：true。 示例：
interval：在自動循環項目之間延遲的時間量。如果為false，則旋轉木馬將不會自動循環。 預設值：5000。 示例：
pause：在mouseenter時暫停旋轉木馬的循環，並在mouseleave時恢復旋轉木馬的循環。 預設值：“hover”。 示例：
外掛標籤
開發者團隊
② 後台搜尋「Agnosia Bootstrap Carousel by AuSoft」→ 直接安裝（推薦）
原文外掛簡介
Agnosia Bootstrap Carousel hooks the shortcode with attribute type="carousel" in order to show a Bootstrap Carousel based on the selected images and their titles and descriptions.
This plugin assumes either your theme includes the necessary Bootstrap javascript and CSS files to display the carousel properly, or that you have included those files on your own. It will not include the files for you, so if they are not present, the carousel will not work and you will only obtain its bare HTML.
Basic example:
Required attributes:
type: it needs to be type="carousel".
ids: you must provide a list of ids corresponding to attachments, like ids="1,2,3".
Otherwise, the default shortcode function will be processed instead of this plugin’s one.
Optional attributes:
name: any name. String will be sanitize to be used as an HTML ID. Recommended when you want to have more than one carousel in the same page. Default: agnosia-bootstrap-carousel. Example:
indicators: indicators position. Accepted values: before-inner, after-inner, after-control, false (hides indicators). Default: before-inner. Example:
width: carousel container width, in px or %. Default: not set. Example:
height: carousel item height, in px or %. Default: not set. Example:
titletag: define HTML tag for image title. Default: h4. Example:
wpautop: auto-format text. Default: true. Example:
title: show or hide image title. Set false to hide. Default: true. Example:
text: show or hide image text. Set false to hide. Default: true. Example:
containerclass: extra class for carousel container. Default: not set. Example:
itemclass: extra class for carousel item. Default: not set. Example:
captionclass: extra class for item caption. Default: not set. Example:
control: control arrows display. Accepted values: true (to show), false (to hide). Default: true. Example:
interval: the amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. Default: 5000. Example:
pause: pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. Default: “hover”. Example:
size: size for image attachment. Accepted values: thumbnail, medium, large, full. Default: full. See wp_get_attachment_image_src() for further reference. Example:
Native supported attributes:
orderby: Alternative order for your images. Example:
link: where your image titles will link to. Accepted values: file, none and empty. An empty value will link to your attachment’s page. Example:
Extending
This plugin offers hooks for actions and filters, so you can modify its functionality or add your own.
Action hooks:
agnosia_bootstrap_carousel_before_init: Do something before the carousel is loaded.
agnosia_bootstrap_carousel_init: Do something after the carousel is loaded.
Filter hooks:
agnosia_bootstrap_carousel_attributes: Modify the attributes passed to the shortcode.
agnosia_bootstrap_carousel_posts: Modify the $post objects that the shortcode is using.
agnosia_bootstrap_carousel_container_style: Modify the carousel container style.
agnosia_bootstrap_carousel_item_style: Modify the style of the carousel items.
agnosia_bootstrap_carousel_output: Modify the full HTML output of the carousel.
agnosia_bootstrap_carousel_container: Modify the HTML output of the carousel container tag.
agnosia_bootstrap_carousel_inner: Modify the HTML output of the carousel inner tag.
agnosia_bootstrap_carousel_caption_container: Modify the HTML output of the caption container tag.
agnosia_bootstrap_carousel_img_container: Modify the HTML output of the image container tag.
agnosia_bootstrap_carousel_img: Modify the HTML output of the item image tag.
agnosia_bootstrap_carousel_excerpt: Modify the HTML output of the image caption.
agnosia_bootstrap_carousel_indicators: Modify the HTML output of the indicators element.
agnosia_bootstrap_carousel_control: Modify the HTML output of the control element.
agnosia_bootstrap_carousel_javascript: Modify the output of the carousel Javascript.
agnosia_bootstrap_carousel_make_array: Modify the list of $post IDs that the carousel is using.
Contributing
You can make suggestions and submit your own modifications to this plugin on Github.
For more information, visit our website.
