{"id":15957795,"url":"https://github.com/finanalyst/grav-plugin-scrolled-table-shortcode","last_synced_at":"2025-10-29T22:12:20.064Z","repository":{"id":80341163,"uuid":"119684798","full_name":"finanalyst/grav-plugin-scrolled-table-shortcode","owner":"finanalyst","description":"A shortcode for the GRAV flat file CMS","archived":false,"fork":false,"pushed_at":"2018-06-07T03:20:40.000Z","size":36,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-02T05:05:46.544Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/finanalyst.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-31T12:33:30.000Z","updated_at":"2018-06-07T03:14:08.000Z","dependencies_parsed_at":"2023-06-05T21:30:35.718Z","dependency_job_id":null,"html_url":"https://github.com/finanalyst/grav-plugin-scrolled-table-shortcode","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finanalyst%2Fgrav-plugin-scrolled-table-shortcode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finanalyst%2Fgrav-plugin-scrolled-table-shortcode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finanalyst%2Fgrav-plugin-scrolled-table-shortcode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finanalyst%2Fgrav-plugin-scrolled-table-shortcode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/finanalyst","download_url":"https://codeload.github.com/finanalyst/grav-plugin-scrolled-table-shortcode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247157046,"owners_count":20893202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-07T14:00:54.342Z","updated_at":"2025-10-29T22:12:15.007Z","avatar_url":"https://github.com/finanalyst.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Scrolled Table Shortcode Plugin\n\nThe **Scrolled Table Shortcode** Plugin is for [Grav CMS](http://github.com/getgrav/grav). It provides a ShortCode that wraps a table so that the content in the body of the table will scroll within the table body. It only uses css, no javascript.\n\n## Installation\n\nInstalling the **Scrolled Table Shortcode** plugin can be done in one of two ways. The GPM (Grav Package Manager) installation method enables you to quickly and easily install the plugin with a simple terminal command, while the manual method enables you to do so via a zip file.\n\n### GPM Installation (Preferred)\n\nThe simplest way to install this plugin is via the [Grav Package Manager (GPM)](http://learn.getgrav.org/advanced/grav-gpm) through your system's terminal (also called the command line).  From the root of your Grav install type:\n\n    bin/gpm install scrolled-table-shortcode\n\nThis will install the **Scrolled Table Shortcode** plugin into your `/user/plugins` directory within Grav. Its files can be found under `/your/site/grav/user/plugins/scrolled-table-shortcode`.\n\n### Manual Installation\n\nTo install this plugin, just download the zip version of this repository and unzip it under `/your/site/grav/user/plugins`. Then, rename the folder to `scrolled-table-shortcode`. You can find these files on [GitHub](https://github.com/finanalyst/grav-plugin-scrolled-table-shortcode) or via [GetGrav.org](http://getgrav.org/downloads/plugins#extras).\n\nYou should now have all the plugin files under\n\n    /your/site/grav/user/plugins/scrolled-table-shortcode\n\n\u003e NOTES: This plugin is a modular component for Grav which requires [Grav](http://github.com/getgrav/grav) and the [Error](https://github.com/getgrav/grav-plugin-error) and [Problems](https://github.com/getgrav/grav-plugin-problems) to operate.  \nThe [ShortCode Core](https://github.com/getgrav/grav-plugin-shortcode-core)  plugin is also required and is automatically installed if using Admin plugin.\n\n## Configuration\n\nBefore configuring this plugin, you should copy the `user/plugins/sqlite/scrolled-table-shortcode.yaml` to `user/config/plugins/scrolled-table-shortcode.yaml` and only edit that copy.\n\nHere is the default configuration and an explanation of available options:\n\n```yaml\nenabled: true\nheight: 55\nwidth: 80\n```\n\n`enabled` turns on the plugin for the whole site, default is true  \n`height` is the height of the table container in `vh` css units (percentage of viewport height). A range from 10 to 90 is recommended.  \n`width` is the width of the table container in `vw` css units (percentage of viewport width). A range from 10 to 90 is recommended.\n\n## Usage\nIn the body of the page:\n```\n[scrolled-table]\n\u003c!--- the content of your table in md format ---\u003e\n[/scrolled-table]\n```\nFor example:\n```\n[scrolled-table]\n|Field 1|Field2|Field3|\n|---------|---------|--------|\n|3|4|5|\n|9|10|11|\n|3|4|5|\n|9|10|11|\n|3|4|5|r\n|9|10|11|\n|3|4|5|\n|9|10|11|\n[/scrolled-table]\n```\nThis will render as:\n```html\n\u003cdiv class=\"GravScrolledTable\" style=\"height: 25vh; width: 80vw\"\u003e\n  \u003ctable\u003e\n    \u003cthead\u003e\n      \u003ctr\u003e\u003cth\u003eField 1\u003c/th\u003e\u003cth\u003eField2\u003c/th\u003e\u003cth\u003eField3\u003c/th\u003e\u003c\\tr\u003e\n    \u003c/thead\u003e\n    \u003ctbody\u003e\n      \u003ctr\u003e\u003cth\u003e3\u003c/th\u003e\u003cth\u003e4\u003c/th\u003e\u003cth\u003e5\u003c/th\u003e\n         ..... ETC ETC\n        ....\n      \u003c/tr\u003e\n    \u003c/tbody\u003e\n\u003c/div\u003e\n```\nThe table must have `\u003cthead\u003e` and `\u003ctbody\u003e` sections, which are provided automatically with Markdown in the form in the example.\n\n## Credits\n\nCss solution to table body scrolling based on [this stackoverflow answer by G-Cyr](https://stackoverflow.com/a/23989771).\n\nThe scss mixins for the css were developed by [Matthieu Aussaguel]( http://www.mynameismatthieu.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffinanalyst%2Fgrav-plugin-scrolled-table-shortcode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffinanalyst%2Fgrav-plugin-scrolled-table-shortcode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffinanalyst%2Fgrav-plugin-scrolled-table-shortcode/lists"}