{"id":19692164,"url":"https://github.com/getgrav/grav-plugin-shortcode-media","last_synced_at":"2026-01-18T20:32:44.214Z","repository":{"id":143186910,"uuid":"56087617","full_name":"getgrav/grav-plugin-shortcode-media","owner":"getgrav","description":"Grav Shortcode Media Plugin","archived":false,"fork":false,"pushed_at":"2025-11-17T16:23:30.000Z","size":33,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"develop","last_synced_at":"2025-11-17T18:16:32.560Z","etag":null,"topics":["grav","grav-plugin","shortcode"],"latest_commit_sha":null,"homepage":"https://getgrav.org","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/getgrav.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}},"created_at":"2016-04-12T18:24:49.000Z","updated_at":"2025-11-17T16:23:29.000Z","dependencies_parsed_at":"2023-09-05T05:00:42.386Z","dependency_job_id":null,"html_url":"https://github.com/getgrav/grav-plugin-shortcode-media","commit_stats":{"total_commits":10,"total_committers":2,"mean_commits":5.0,"dds":"0.19999999999999996","last_synced_commit":"03e64e0ea97fa3dfb20a91f3556783b81ec64a01"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/getgrav/grav-plugin-shortcode-media","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getgrav%2Fgrav-plugin-shortcode-media","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getgrav%2Fgrav-plugin-shortcode-media/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getgrav%2Fgrav-plugin-shortcode-media/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getgrav%2Fgrav-plugin-shortcode-media/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getgrav","download_url":"https://codeload.github.com/getgrav/grav-plugin-shortcode-media/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getgrav%2Fgrav-plugin-shortcode-media/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28549832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T19:56:05.265Z","status":"ssl_error","status_checked_at":"2026-01-18T19:55:54.685Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["grav","grav-plugin","shortcode"],"created_at":"2024-11-11T19:12:29.332Z","updated_at":"2026-01-18T20:32:44.195Z","avatar_url":"https://github.com/getgrav.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grav Shortcode Media Plugin\n\n## About\n\nThe **Shortcode Media** plugin provides various media-related shortcodes to embed content.\n\nIt currently provides:\n\n* IFrame\n* PDF\n* DocViewer\n* SlideShare\n\n## Installation\n\nTypically a plugin should be installed via [GPM](http://learn.getgrav.org/advanced/grav-gpm) (Grav Package Manager):\n\n```\n$ bin/gpm install shortcode-media\n```\n\nAlternatively it can be installed via the [Admin Plugin](http://learn.getgrav.org/admin-panel/plugins)\n\n## Configuration Defaults\n\n```\nenabled: true\ngoogle_viewer: false\n```\n\nThe `google_viewer` uses the Google Docs \"Viewer\" to view the PDF rather than letting the browser's built in viewer handle things. THis provides a more consistent viewing experience between browsers and platforms.  However, it only works for externally accessible URLs.\n\n## Available Shortcodes\n\nThis plugin provides a variety of shortcodes, each with a specific purpose:\n\n#### IFrame\n\nYou can display a specific URL in an iframe:\n\n```\n[iframe url=\"https://getgrav.org\" /]\n```\n\nYou can also provide a specific `width` and `height`:\n\n```\n[iframe url=\"https://getgrav.org\" width=\"800\" height=\"600\" /]\n```\n\nor full width available:\n\n```\n[iframe url=\"https://getgrav.org\" width=\"100%\" height=\"800\" /]\n```\n\nalso `class`es and `id`s can be set:\n\n```\n[iframe url=\"https://getgrav.org\" class=\"external iframe\" id=\"grav-homepage\" /]\n```\n\n#### PDF\n\nVery similar to the IFrame shortcode above, you can pass a full URL or a local page media file:\n\n```\n[pdf url=\"https://somesite.com/media/planning-process.pdf\" /]\n```\n\nlocal file:\n\n```\n[pdf url=\"planning-process.pdf\" /]\n```\n\nYou can also use `width`, `height`, `class`, and `id` like IFrame shortcode.\n\nTo enable to disable the **Google Docs Viewer** you can pass the google param:\n\n```\n[pdf url=\"planning-process.pdf\" google=\"true\" /]\n```\n\n#### DocViewer\n\nThe PDF shortcode is actually very generic and can display any file inline as an iframe (as long as the browser supports it).  But if the browser doesn't support it, Google probably does, so `docviewer` shortcode is an alias:\n\n```\n[docviewer url=\"important-numbers.xls\" google=\"true\" /]\n```\n\n#### SlideShare\n\nAn example of the SlideShare shortcode is as follows:\n\n```\n[slideshare id=\"58575464\"]\n```\n\nOptional parameters let you set a variety of common SlideShare options:\n\n```\n[slideshare id=\"58575464\" width=\"600\" height=\"500\" start=\"2\" align=\"center\" class=\"my-slideshare\" style=\"border:1px solid blue\"]\n```\n\n| NOTE: this format is compatible with the WordPress shortcode syntax that is available as part of the share option for any slide set.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetgrav%2Fgrav-plugin-shortcode-media","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetgrav%2Fgrav-plugin-shortcode-media","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetgrav%2Fgrav-plugin-shortcode-media/lists"}