{"id":26278734,"url":"https://github.com/textpattern/textpattern-plugins-website","last_synced_at":"2025-05-07T00:43:17.857Z","repository":{"id":29156291,"uuid":"116845491","full_name":"textpattern/textpattern-plugins-website","owner":"textpattern","description":"Textpattern CMS Plugins website.","archived":false,"fork":false,"pushed_at":"2024-07-22T07:31:34.000Z","size":2578,"stargazers_count":7,"open_issues_count":4,"forks_count":1,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-29T11:25:38.953Z","etag":null,"topics":["textpattern","textpattern-plugin","textpattern-website","web-design","website"],"latest_commit_sha":null,"homepage":"https://plugins.textpattern.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/textpattern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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-09T17:05:39.000Z","updated_at":"2024-07-22T07:31:31.000Z","dependencies_parsed_at":"2024-11-06T03:14:07.269Z","dependency_job_id":"ccf95af2-e26e-4931-8438-3dc35a02c6ea","html_url":"https://github.com/textpattern/textpattern-plugins-website","commit_stats":{"total_commits":305,"total_committers":7,"mean_commits":43.57142857142857,"dds":"0.10163934426229504","last_synced_commit":"497d4c2bc22d26bce16622dd0472748e29bee140"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textpattern%2Ftextpattern-plugins-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textpattern%2Ftextpattern-plugins-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textpattern%2Ftextpattern-plugins-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/textpattern%2Ftextpattern-plugins-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/textpattern","download_url":"https://codeload.github.com/textpattern/textpattern-plugins-website/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252793559,"owners_count":21805053,"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":["textpattern","textpattern-plugin","textpattern-website","web-design","website"],"created_at":"2025-03-14T13:17:42.483Z","updated_at":"2025-05-07T00:43:17.814Z","avatar_url":"https://github.com/textpattern.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Textpattern plugins website\n\n[![Build Status](https://travis-ci.com/textpattern/textpattern-plugins-website.svg)](https://travis-ci.com/textpattern/textpattern-plugins-website)\n\nOfficial 2020+ plugins website of the [Textpattern](https://textpattern.com/) project. **Requires Textpattern 4.8.2 or later.**\n\nPulls supporting data from the [Textpattern curated plugins list repository](https://github.com/textpattern/textpattern-curated-plugins-list).\n\n## Supported web browsers\n\n* Chrome, Edge, Firefox, Safari and Opera the last two recent stable releases.\n* Internet Explorer 11.\n* Firefox ESR latest major point release.\n\nOlder versions of the above and other browsers may work, but these are the ones we verify.\n\n## Requirements\n\nBuilding this repository requires:\n\n* [Node.js](https://nodejs.org/)\n* [Grunt](https://gruntjs.com/)\n* [Composer](https://getcomposer.org/)\n\n## Setup\n\n### Installing required tools\n\nThe project uses [Grunt](https://gruntjs.com/) to run tasks. First make sure you have base dependencies installed: [Node.js](https://nodejs.org/) and [Grunt](https://gruntjs.com/). You can install Node using the [installer](https://nodejs.org/), Composer using the [installer](https://getcomposer.org/), and Grunt with npm:\n\n```ShellSession\n$ npm install -g grunt-cli\n```\n\nConsult the Grunt documentation for more instructions if necessary.\n\n### Installing dependencies\n\nAfter you have the base dependencies taken care of, you can install the project's dependencies. Navigate to the project's directory, and run the dependency manager:\n\n```ShellSession\n$ cd textpattern-plugins-website\n$ npm install\n$ composer install\n```\n\n**npm** installs Node modules for Grunt and **composer** installs PHP libraries.\n\n## Building\n\nThis repository hosts sources and needs to be built before it can be used. After you have installed all dependencies, you will be able to run tasks using Grunt, including building:\n\n```ShellSession\n$ grunt @task@\n```\n\nWhere the `@task@` is either `build` or `watch`.\n\n* The `build` task builds the project.\n* The `watch` task will launch a task that watches for file changes; the project is then automatically built if a source file is modified.\n\n## Shortcodes\n\nTextpattern 4.7 introduced support for user-definable `\u003ctxp:output_form /\u003e` attributes (and also the short tags syntax `\u003ctxp::...\u003e`), allowing for our own version of 'shortcodes' within articles (**note:** remember to also use `notextile.` when within Textile content). This site uses the following tags:\n\n### Superceded plugin flag\n\nPlugins can be flagged as 'superseded' when there is deemed a better method to achieve the same end task. For example, newer core Textpattern tags/attributes have been developed, a more modern alternative plugin, or if Textpattern [custom short-tags and shortcodes](https://docs.textpattern.com/tags/shortcodes/custom-short-tags-and-shortcodes) can be used instead.\n\nThe shortcode creates an alert block on the page showing an advisory listing the new method and a link to the new methods' documentation.\n\nTo create a superceded plugin flag:\n\n    \u003ctxp::superseded type=\"\" location=\"\" /\u003e\n\n`type` is used to explain the replacement method that is available. For example, `shortcodes`, `alternative plugin`, `core tags`, etc. Please try to keep the naming convention consistent throughout the CMS if possible.\n\n`location` is the *full URL* to the replacement method; be that documentation and/or examples via shortcodes, the webpage of the alternative plugin, the documentation page of the core tags, etc.\n\nFor example:\n\n    \u003ctxp::superseded type=\"shortcodes\" location=\"https://example.com/example.html\" /\u003e\n\n### Image\n\nTo create a HTML5 image snippet:\n\n    \u003ctxp::media_image id=\"\" dark-option=\"\" set-width=\"\" set-height=\"\" /\u003e\n\n`id` accepts either a single image ID, or comma separated image IDs if you want multiple images. For blogs/articles the ideal image width is `832` pixels for the standard resolution version and `1664` pixels for the double resolution version (which is optional, but should be provided if possible).\n\n`dark-option` is optional (for a single image ID), for if you need to provide an alternative image when website is in Dark Mode.\n\n`set-width` and `set-height` are optional (for a single image ID), for if you need to provide explicit maximum dimensions (in pixels) for an image. Otherwise (when not set), images default to being fully responsive (expanding to fill their container).\n\nFor example, comma separated image IDs:\n\n    \u003ctxp::media_image id=\"41, 42, 50\" /\u003e\n\nFor example, image with an alternative dark theme version and a set width and height in pixels:\n\n    \u003ctxp::media_image id=\"51\" dark-option=\"52\" set-width=\"400\" set-height=\"125\" /\u003e\n\n### Video\n\nTo create a HTML5 video snippet:\n\n    \u003ctxp::media_video width=\"\" height=\"\" mp4-url=\"\" webm-url=\"\" poster-url=\"\" name=\"\" description=\"\" duration-seconds=\"\"/\u003e\n\n`poster-url`, `name`, `description` and `duration-seconds` are optional, but should be provided if possible to provide valid Schema.org microdata. If not used, remove those attributes from your shortcode.\n\nFor example:\n\n    \u003ctxp::media_video width=\"640\" height=\"480\" mp4-url=\"/video/video1.mp4\" webm-url=\"/video/video1.webm\" poster-url=\"/video/video1-poster.png\" name=\"Cat video\" description=\"My great video of cats.\" duration-seconds=\"20\" /\u003e\n\n### File\n\nTo create a file download snippet:\n\n    \u003ctxp::media_file category=\"\" filename=\"\" large-button=\"\" /\u003e\n\n`category` and `filename` are interchangeable (use one or the other, where appropriate) - if both are provided then `category` is used in preference and `filename` is ignored.\n\n`large-button` is optional. If set to `1`, this will render a larger style button.\n\nFor example:\n\n    \u003ctxp::media_file category=\"current-release-zip\" large-button=\"1\" /\u003e\n\n## Plugins used\n\nAll plugins we use are installed via Composer:\n\n* [`etc_cache`](https://github.com/etc-plugins/etc_cache) ✓ Composer\n* [`smd_thumbnail`](https://github.com/bloke/smd_thumbnail) ✓ Composer\n\n## License\n\nLicensed under the [GPLv2 license](https://github.com/textpattern/textpattern-plugins-website/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftextpattern%2Ftextpattern-plugins-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftextpattern%2Ftextpattern-plugins-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftextpattern%2Ftextpattern-plugins-website/lists"}