{"id":18485629,"url":"https://github.com/bootscore/bs-grid","last_synced_at":"2025-04-08T19:32:47.693Z","repository":{"id":41114972,"uuid":"335272747","full_name":"bootscore/bs-grid","owner":"bootscore","description":"WordPress plugin to show posts, child-pages or custom post types in grid / list cards or heroes in Bootscore theme.","archived":false,"fork":false,"pushed_at":"2024-12-13T08:49:32.000Z","size":428,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T11:52:57.090Z","etag":null,"topics":["bootscore","bootstrap5","grid-layout","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://bootscore.me/plugins/bs-grid/","language":"PHP","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/bootscore.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"bootscore"}},"created_at":"2021-02-02T11:55:19.000Z","updated_at":"2025-01-14T10:15:21.000Z","dependencies_parsed_at":"2023-10-04T13:17:26.583Z","dependency_job_id":"bcfa7763-96d8-4535-a378-953c70139017","html_url":"https://github.com/bootscore/bs-grid","commit_stats":{"total_commits":157,"total_committers":3,"mean_commits":"52.333333333333336","dds":0.03821656050955413,"last_synced_commit":"58467e8bbdc3fff220e7ae78ad503e1bab51b2db"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootscore%2Fbs-grid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootscore%2Fbs-grid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootscore%2Fbs-grid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bootscore%2Fbs-grid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bootscore","download_url":"https://codeload.github.com/bootscore/bs-grid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247912780,"owners_count":21017045,"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":["bootscore","bootstrap5","grid-layout","wordpress","wordpress-plugin"],"created_at":"2024-11-06T12:45:49.074Z","updated_at":"2025-04-08T19:32:47.442Z","avatar_url":"https://github.com/bootscore.png","language":"PHP","readme":"# bs Grid\n\n[![Packagist Prerelease](https://img.shields.io/packagist/vpre/bootscore/bs-grid?logo=packagist\u0026logoColor=fff)](https://packagist.org/packages/bootscore/bs-grid)\n[![Github All Releases](https://img.shields.io/github/downloads/bootscore/bs-grid/total.svg)](https://github.com/bootscore/bs-grid/releases)\n\nWordPress plugin to show posts, pages or custom-post-types in grid / list cards, heroes, accordion or tabs via shortcode in Bootscore theme.\n\n- Demo and documentation: https://bootscore.me/documentation/bs-grid/\n\n\u003cimg src=\"https://lh3.googleusercontent.com/pw/AM-JKLUxNADNzUEZvT53A8bP1QXSGubd4GEHdhPZw4wx3IsCu0A4XT7uM0SNBfrTzplvmE9jFBXr_Twytum2cWrDg0Scgroha0IRcp_73Y6NL3GZUrOlVbeL4-WeQS-UbXL2JVmLxjqq7JFdDTbPXivTtJsjRg=w1904-h1530-no\" alt=\"bs-grid\"\u003e\n\n## Installation\n1. Download latest release [bs-grid.zip](https://github.com/bootscore/bs-grid/releases/latest/download/bs-grid.zip). \n2. In your admin panel, go to Plugins \u003e and click the Add New button.\n3. Click Upload Plugin and Choose File, then select the Plugin's .zip file. Click Install Now.\n4. Click Activate to use your new Plugin right away.\n\n## Usage\n\nSelect template you want to use by replacing `bs-*` placeholder in shortcode examples.\n\n```\n[bs-grid]\n```\n\n- `bs-grid` shows items in 4 (xxl), 3 (lg), 2 (md) and 1 (sm) column cards.\n- `bs-list` shows items in 1 column vertical cards (md) and flip into 1 column horizontal cards (lg).\n- `bs-hero` shows hero items with background-images. \n- `bs-accordion` shows items with full content in a Bootstrap accordion.\n- `bs-tabs` shows items with full content in Bootstrap tabs.\n\n## Posts\n\n### Shortcode to show posts by category\n```\n[bs-* type=\"post\" category=\"cars, boats\" order=\"ASC\" orderby=\"date\" posts=\"6\"]\n```   \n\n#### Options\n- `category=\"\"` category-slug, multiple categories separated by comma\n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n- `posts=\"\"` amount of posts\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n- `tags=\"false\"` hide tags\n- `categories=\"false\"` hide categories\n\n### Shortcode to show posts by tags\n```\n[bs-* type=\"post\" tax=\"post_tag\" terms=\"bikes, motorbikes\" order=\"DESC\" orderby=\"date\" posts=\"5\"]\n```\n\n#### Options\n- `tax=\"\"` taxonomy (post_tag)\n- `terms=\"\"` tags-slug, multiple terms separated by comma\n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n- `posts=\"\"` amount of posts\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n- `tags=\"false\"` hide tags\n- `categories=\"false\"` hide categories\n\n### Shortcode to show single posts by id\n```\n[bs-* type=\"post\" id=\"1, 15\"]\n```\n\n#### Options\n- `id=\"\"` post id, multiple ids separated by comma \n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n- `tags=\"false\"` hide tags\n- `categories=\"false\"` hide categories\n\n## Pages\n\n### Shortcode to show child-pages by parent-page id\n```\n[bs-* type=\"page\" post_parent=\"21\" order=\"ASC\" orderby=\"title\" posts=\"6\"]\n```\n\nShowing child-pages in parent-page is very useful to avoid empty parent-pages.\n\n#### Options\n- `post_parent=\"\"` parent-page id\n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n- `posts=\"\"` amount of pages\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n\n### Shortcode to show single pages by id\n```\n[bs-* type=\"page\" id=\"2, 25\"]\n```\n\n#### Options\n- `id=\"\"` page id, multiple ids separated by comma \n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n\n## Custom Post Types\n\n### Shortcode to show custom-post-types by terms\n```\n[bs-* type=\"isotope\" tax=\"isotope_category\" terms=\"dogs, cats\" order=\"DESC\" orderby=\"date\" posts=\"5\"]\n```\n\n#### Options:\n- `type=\"\"` type of custom-post-type\n- `tax=\"\"` taxonomy\n- `terms=\"\"` terms-slug, multiple terms separated by comma\n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n- `posts=\"\"` amount of custom-post-types\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n\n### Shortcode to show single custom-post-types by id\n```\n[bs-* type=\"isotope\" id=\"33, 31\"]\n```\n\n#### Options\n- `id=\"\"` custom-post-type's id, multiple ids separated by comma \n- `order=\"\"` ASC or DESC\n- `orderby=\"\"` date, title, or rand\n\n##### Additional options `bs-grid`, `bs-list` and `bs-hero`\n- `excerpt=\"false\"` hide excerpt\n\n## Overriding templates via theme\nTemplate files can be found within the `/bs-grid-main/templates/` plugin directory.\n\nEdit files in an upgrade-safe way using overrides. Copy the template into a directory within your theme named `/bs-grid/` keeping the same file structure but removing the `/templates/` subdirectory. Path must be `/your-theme/bs-grid/[file].php`.\n\nThe copied file will now override the bs Grid template file. Change cards, classes or HTML as you want.\n\n### Templates that can be overridden\n- `sc-grid.php`\n- `sc-list.php`\n- `sc-hero.php`\n- `sc-accordion.php`\n- `sc-tabs.php`\n\n## License \u0026 Credits\n- bs Grid, MIT License https://github.com/bootscore/bs-grid/blob/main/LICENSE\n- Plugin Update Checker, YahnisElsts, MIT License https://github.com/YahnisElsts/plugin-update-checker/blob/master/license.txt\n","funding_links":["https://github.com/sponsors/bootscore"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbootscore%2Fbs-grid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbootscore%2Fbs-grid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbootscore%2Fbs-grid/lists"}