Title: Shortcode Table of Contents Author: James Kemp Published: نوامبر 29, 2017 Last modified: جولای 31, 2018 --- جستجوی افزونه‌ها ![](https://ps.w.org/shortcode-toc/assets/banner-772x250.png?rev=1778245) این افزونه **با آخرین 3 نسخه اصلی وردپرس تست نشده است**. ممکن است دیگر نگهداری یا پشتیبانی نشود و ممکن است هنگام استفاده با نسخه های جدیدتر وردپرس مشکلات سازگاری داشته باشد. ![](https://ps.w.org/shortcode-toc/assets/icon-256x256.png?rev=1778245) # Shortcode Table of Contents توسط [James Kemp](https://profiles.wordpress.org/jamesckemp/) [دانلود](https://downloads.wordpress.org/plugin/shortcode-toc.zip) * [جزئیات](https://fa-af.wordpress.org/plugins/shortcode-toc/#description) * [نقد و بررسی‌ها](https://fa-af.wordpress.org/plugins/shortcode-toc/#reviews) * [نصب](https://fa-af.wordpress.org/plugins/shortcode-toc/#installation) * [توسعه](https://fa-af.wordpress.org/plugins/shortcode-toc/#developers) [پشتیبانی](https://wordpress.org/support/plugin/shortcode-toc/) ## توضیحات Simply use the `[toc content=".your-container"]` shortcode to automatically generate a table of contents for any HTML container. The shortcode accepts a number of parameters: * `content` _string_ **required** A CSS selector indicating the container of your content. * `headers` _string_ A comma separated list of heading selectors that you want to include. * `speed` _int_ Speed of sliding back to top. * `anchor-class` _string_ Class of anchor links. * `anchor-text` _string_ Prepended or appended to anchor headings. Leave blank to disable anchor links. * `top_class` _string_ Back to top button or link class. * `spy` _true/false_ Enable scroll spy. This will highlight the list items as you scroll past them. * `position` _append/prepend_ Position of anchor text. * `spy-offset` _int_ Specify heading offset for spy scrolling. ## عکس‌های صفحه [⌊Add the [toc] shortcode to any post/page/custom-post-type, at any position in the content.⌉⌊Add the [toc] shortcode to any post/page/custom-post-type, at any position in the content.⌉[ Add the `[toc]` shortcode to any post/page/custom-post-type, at any position in the content. [⌊A nested list will be generated based on the headings within your chosen HTML element.⌉⌊A nested list will be generated based on the headings within your chosen HTML element.⌉[ A nested list will be generated based on the headings within your chosen HTML element. [⌊Add the anchor-text parameter.⌉⌊Add the anchor-text parameter.⌉[ Add the `anchor-text` parameter. [⌊When the anchor-text parameter is set, the text will be appended to your headings so your users can easily copy the link to that section.⌉⌊When the anchor-text parameter is set, the text will be appended to your headings so your users can easily copy the link to that section.⌉[ When the `anchor-text` parameter is set, the text will be appended to your headings so your users can easily copy the link to that section. ## نصب 1. Upload the plugin files to the `/wp-content/plugins/shortcode-toc` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress ## سوالات متداول Installation Instructions 1. Upload the plugin files to the `/wp-content/plugins/shortcode-toc` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress Can I use the shortcode multiple times on a page? No. Currently it’ll only work once per page. The table of contents isn’t showing up. Did you set the `content` parameter of the shortcode to a valid CSS selector on your page? This is a required argument. Can I build a table of contents for just h2 and h3 tags? Yup, your shortcode would look like this `[toc content=".your-container" headers ="h2,h3"]` Is there a PHP version of the shortcode? You can use the `do_shortcode()` function like this: ``` ``` ## نقد و بررسی‌ها ![](https://secure.gravatar.com/avatar/ec90659e38270e106cb6c0b4ee0c3a35a735ed8b76aff7c0d3cc5dbdb4f48378? s=60&d=retro&r=g) ### 󠀁[No cyrillic](https://wordpress.org/support/topic/no-cyrillic-3/)󠁿 [hlammm](https://profiles.wordpress.org/hlammm/) فبروری 26, 2019 It does not work if the site is in Cyrillic. ![](https://secure.gravatar.com/avatar/8e95c0528a1959250adbcf5d38b78b8b4ddbbacc1410e786f1a23d6c4271bea2? s=60&d=retro&r=g) ### 󠀁[Filter shortcode presets](https://wordpress.org/support/topic/filter-shortcode-presets/)󠁿 [nenontwerp](https://profiles.wordpress.org/nenontwerp/) آکتوبر 28, 2018 Great simple plugin! There are no filters available to set shortcode defaults. My clients dont know the right class names to set the parameter ‘content’. So if you want to set the default class for ‘content’ or set the default set of headers, use filter ‘shortcode_atts_{shortcode}’. This way you the shortcode get much cleaner like ‘[toc]’. If the parameters in the shortcode are set, the default are over ruled. Filter like: add_action('shortcode_atts_toc','nen_shortcode_atts_toc'); function nen_shortcode_atts_toc( $out ) { if( isset( $out['content'] ) && empty( $out['content'])) $out['content'] = '.entry-content'; if( isset( $out['headers'] ) && $out['headers'] == 'h1, h2, h3, h4, h5, h6' ) $out['headers'] = 'h2, h3, h4'; return $out; } Hopefully James Kemp can apply a filter to add custom content before and/or after the div ‘ shortcode-toc’. This way we can add a custom toc-header or something. Thanx! ![](https://secure.gravatar.com/avatar/d97589e1287a4c27a39be552da7473323c1e697a9a6abf2d18d81935e5debfd5? s=60&d=retro&r=g) ### 󠀁[So simple and useful! Does what it promises 🙂 Thx bro!](https://wordpress.org/support/topic/so-simple-and-useful-does-what-it-promises-thx-bro/)󠁿 [smith64fx](https://profiles.wordpress.org/smith64fx/) آگست 30, 2018 I’m really happy with it ^^ ![](https://secure.gravatar.com/avatar/524156a645b53e512d163867db3acf844fcff4c68d44feced01e13041e0acad4? s=60&d=retro&r=g) ### 󠀁[Just what I need](https://wordpress.org/support/topic/just-what-i-need-94/)󠁿 [resident82](https://profiles.wordpress.org/resident82/) جون 2, 2018 I needed to make navigation for posts, and this is a ready-made automated solution. Many thanks. ![](https://secure.gravatar.com/avatar/a4f72aa0ad82961554b9ecfa3201df9d41fc777704856ff00b710363284e0b4d? s=60&d=retro&r=g) ### 󠀁[Lightweight & versatile](https://wordpress.org/support/topic/lightweight-versatile/)󠁿 [](https://profiles.wordpress.org/t4tsu/) دسمبر 28, 2017 1 پاسخ Very lightweight and at the same time versatile enough with useful options. ![](https://secure.gravatar.com/avatar/ef861245e900fd7b6cfdab595980ad7597ea6f9973c4fc0a9dca3afbbf5c223b? s=60&d=retro&r=g) ### 󠀁[the best TOC](https://wordpress.org/support/topic/the-best-toc/)󠁿 [drweby2](https://profiles.wordpress.org/drweby2/) دسمبر 26, 2017 1 پاسخ the best TOC [ خواندن تمامی 6 نقد و بررسی‌ ](https://wordpress.org/support/plugin/shortcode-toc/reviews/) ## توسعه دهندگان و همکاران “Shortcode Table of Contents” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند. مشارکت کنندگان * [ James Kemp ](https://profiles.wordpress.org/jamesckemp/) [ترجمه “Shortcode Table of Contents” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/shortcode-toc) ### علاقه‌ مند به توسعه هستید؟ [کد را مرور کنید](https://plugins.trac.wordpress.org/browser/shortcode-toc/), را بررسی کنید [مخزن SVN](https://plugins.svn.wordpress.org/shortcode-toc/), یا مشترک شوید [گزارش توسعه](https://plugins.trac.wordpress.org/log/shortcode-toc/) توسط [RSS](https://plugins.trac.wordpress.org/log/shortcode-toc/?limit=100&mode=stop_on_copy&format=rss). ## گزارش تغییرات **v1.0.3 (31/07/2018)** [fix] Revert back to original anchorific. Bower one was an old version. **v1.0.2 (01/12/2017)** [update] Use latest anchorific. **v1.0.1 (30/11/2017)** [update] Remove anchor text by default. [fix] Ensure ‘spy’ param works with true/false values. **v1.0.0 (29/11/2017)** [release] Initial release. ## اطلاعات * Version **1.0.3** * Last updated **8 سال پیش** * Active installations **300+** * WordPress version ** 4.0 یا بالاتر ** * Tested up to **4.9.29** * Language * [English (US)](https://wordpress.org/plugins/shortcode-toc/) * Tags * [anchors](https://fa-af.wordpress.org/plugins/tags/anchors/)[table of contents](https://fa-af.wordpress.org/plugins/tags/table-of-contents/) [toc](https://fa-af.wordpress.org/plugins/tags/toc/) * [نمایش پیشرفته](https://fa-af.wordpress.org/plugins/shortcode-toc/advanced/) ## امتیازها 4.7 out of 5 stars. * [ 5 5-star reviews ](https://wordpress.org/support/plugin/shortcode-toc/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/shortcode-toc/reviews/?filter=4) * [ 1 3-star review ](https://wordpress.org/support/plugin/shortcode-toc/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/shortcode-toc/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/shortcode-toc/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/shortcode-toc/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/shortcode-toc/reviews/) ## مشارکت کنندگان * [ James Kemp ](https://profiles.wordpress.org/jamesckemp/) ## پشتیبانی چیزی برای گفتن دارید؟ نیاز به کمک دارید؟ [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/shortcode-toc/) ## کمک مالی آیا تمایل دارید از پیشرفت این افزونه حمایت کنید؟ [ کمک مالی به این افزونه ](https://www.paypal.me/jamesckemp/)