{"id":21243162,"url":"https://github.com/llewellynvdm/preupver-plugin","last_synced_at":"2025-03-15T04:13:33.082Z","repository":{"id":227870612,"uuid":"724619075","full_name":"Llewellynvdm/PreUpVer-Plugin","owner":"Llewellynvdm","description":"PreUpVer JS loader for Joomla.","archived":false,"fork":false,"pushed_at":"2023-11-28T13:02:03.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-21T19:49:40.055Z","etag":null,"topics":["namibia"],"latest_commit_sha":null,"homepage":"https://git.vdm.dev/Llewellyn/PreUpVer-Plugin","language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Llewellynvdm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-11-28T13:01:24.000Z","updated_at":"2024-03-06T07:45:17.000Z","dependencies_parsed_at":"2024-03-21T07:15:12.570Z","dependency_job_id":null,"html_url":"https://github.com/Llewellynvdm/PreUpVer-Plugin","commit_stats":null,"previous_names":["llewellynvdm/preupver-plugin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Llewellynvdm%2FPreUpVer-Plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Llewellynvdm%2FPreUpVer-Plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Llewellynvdm%2FPreUpVer-Plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Llewellynvdm%2FPreUpVer-Plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Llewellynvdm","download_url":"https://codeload.github.com/Llewellynvdm/PreUpVer-Plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681078,"owners_count":20330155,"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":["namibia"],"created_at":"2024-11-21T01:04:11.847Z","updated_at":"2025-03-15T04:13:33.053Z","avatar_url":"https://github.com/Llewellynvdm.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PreUpVer Loader (1.0.0)\r\n\r\n## Introduction\r\n\r\nPreUpVer is a versatile JavaScript library designed to automatically update the version numbers of library scripts in your documentation. It identifies specific `\u003cpre\u003e` tags on your webpage and updates them with the latest version tag fetched from a specified repository, ensuring your documentation always displays up-to-date information.\r\n\r\n## How It Works\r\n\r\nPreUpVer operates by searching for `\u003cpre\u003e` tags with a designated class (`preupver`) and using their data attributes to perform version updates. It simplifies the process of keeping your library references up-to-date in documentation.\r\n\r\n### Automatic Detection and Updating\r\n\r\nWhen the webpage loads, PreUpVer finds all `\u003cpre\u003e` tags marked with the `preupver` class. It then extracts necessary details from their data attributes and updates each tag with the latest library version.\r\n\r\n### Usage\r\n\r\n1. **Marking `\u003cpre\u003e` Tags:**\r\n\r\n   Add the `class=\"preupver\"` to `\u003cpre\u003e` tags in your HTML and define the required data attributes for automatic updating:\r\n\r\n   ```html\r\n   \u003cpre id=\"unique-id\" class=\"preupver\"\r\n        data-api-url=\"https://api.github.com/repos/username/library/tags\"\r\n        data-description=\"Description of the library script\"\r\n        data-url=\"https://cdn.jsdelivr.net/gh/username/library@${version}/dist/library.min.js\"\u003e\r\n   \u003c/pre\u003e\r\n   ```\r\n\r\n   Replace `unique-id`, `username`, `library`, and other placeholders with your specific details.\r\n\r\n2. **Attributes Explained:**\r\n\r\n   - `id`: A unique identifier for the `\u003cpre\u003e` tag.\r\n   - `data-api-url`: The API URL to fetch the latest library version.\r\n   - `data-description`: A brief description of the library script.\r\n   - `data-url`: The URL of the script, where `${version}` will be replaced with the latest version number.\r\n\r\n### Example\r\n\r\nCheck out the [tests](https://git.vdm.dev/Llewellyn/PreUpVer/src/branch/master/tests/) folder for the examples we use to test if this library works as expected.\r\n\r\n# Build Details\r\n\r\n+ *Author*: [Llewellyn van der Merwe](mailto:joomla@vdm.io)\r\n+ *Name*: [PreUpVer Loader](https://git.vdm.dev/Llewellyn/PreUpVer)\r\n+ *First Build*: 17th February, 2023\r\n+ *Last Build*: 28th November, 2023\r\n+ *Version*: 1.0.0\r\n+ *Copyright*: Copyright (C) 2022. All Rights Reserved\r\n+ *License*: GNU/GPL Version 2 or later - http://www.gnu.org/licenses/gpl-2.0.html\r\n\r\n\u003e This **plugin** was build with a Joomla [Automated Component Builder](https://www.joomlacomponentbuilder.com).\r\n\u003e Developed by [Llewellyn van der Merwe](mailto:joomla@vdm.io)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllewellynvdm%2Fpreupver-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fllewellynvdm%2Fpreupver-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fllewellynvdm%2Fpreupver-plugin/lists"}