{"id":17153119,"url":"https://github.com/jsonbecker/plugin-bookshop","last_synced_at":"2026-01-05T21:31:05.583Z","repository":{"id":144874493,"uuid":"278689452","full_name":"jsonbecker/plugin-bookshop","owner":"jsonbecker","description":"A Micro.blog plugin for Bookshop.org","archived":false,"fork":false,"pushed_at":"2023-01-17T03:24:37.000Z","size":13,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-29T18:11:28.611Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/jsonbecker.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.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":"2020-07-10T17:04:32.000Z","updated_at":"2024-12-26T18:50:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"62fb5897-2a85-44b5-9812-60c2e8fc71c4","html_url":"https://github.com/jsonbecker/plugin-bookshop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsonbecker%2Fplugin-bookshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsonbecker%2Fplugin-bookshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsonbecker%2Fplugin-bookshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsonbecker%2Fplugin-bookshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jsonbecker","download_url":"https://codeload.github.com/jsonbecker/plugin-bookshop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245276195,"owners_count":20588894,"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-14T21:45:16.632Z","updated_at":"2026-01-05T21:31:00.546Z","avatar_url":"https://github.com/jsonbecker.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# plugin-bookshop\nA Bookshop affiliate plugin for Micro.blog that can be used by other Hugo sites\n\n## Description\n[Bookshop](https://bookshop.org) is an online bookstore connected to independent book sellers across the country. They have an easy to sign up for affiliate program that you can use to earn some money when someone buys a book after clicking on a link you provide.\n\nThis plugin provides a [Hugo shortcode](https://gohugo.io/content-management/shortcodes/) for your Micro.blog (this can be easily used with other Hugo blogs as well) that makes it easy to add affiliate links and widgest from Bookshop to your site.\n\n## Usage\n\nUsing shortcodes are easy. They have a special delimiter, but otherwise, look a lot like HTML. The simplest version of Bookshop works like this:\n\n```html\n{{\u003c bookshop 9781524760380 \u003e}} Shorefall by Robert Jackson Bennett {{\u003c /bookshop \u003e}}\n```\n\nUsing the affiliate ID setup in your Micro.blog plugin, this will produce the following HTML\n\n```html\n\u003ca href=\"https://bookshop.org/a/1234/9781524760380\"\u003eShorefall by Robert Jackson Bennett\u003c/a\u003e\n```\n\nIn the example above, 1234 is a fake affiliate id-- you ID will be there.\n\nYou can also use the Bookshop.org widgets. This requires a little more work, and can be called like so:\n\n```html\n{{\u003c bookshop 9781524760380 book \u003e}} \n```\n\nor\n\n```html\n{{\u003c bookshop 9781524760380 book_button \u003e}} \n```\n\nWhich will turn into the `book` or `book_button` widgets they offer with the correct embed code. \n\nYou can also use named parameters, of which there are two:\n\n- `isbn` which is the ISBN number used as the \"sku\" of the book to generate the link\n- `type` which indicates which embed, book or book_button you want.\n\nWhen not specifying the `type` by name or as the second parameter, you must wrap the link text you want to use in this shortcode or nothing will appear on your site.\n\n### Lists\n\nBookshop now supports list widgets. After considering overloading the `bookshop` shortcode with a `type=\"list\"`, I decided to support this with a separate shortcode. This way the `bookshop` shortcode always supports widgets related to a single book. With this new shortcode, you only need to supply the slug for your list:\n\n```html\n{{\u003c bookshoplist read-2022-a28bc91a-fc4a-4573-bfa4-15c42345ca33 \u003e}}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsonbecker%2Fplugin-bookshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjsonbecker%2Fplugin-bookshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsonbecker%2Fplugin-bookshop/lists"}