{"id":13787301,"url":"https://github.com/NodeBB-Community/nodebb-plugin-recent-cards","last_synced_at":"2025-05-12T00:30:49.958Z","repository":{"id":34284962,"uuid":"38173757","full_name":"NodeBB-Community/nodebb-plugin-recent-cards","owner":"NodeBB-Community","description":"Recent Cards plugin for NodeBB's Persona Theme","archived":false,"fork":false,"pushed_at":"2025-02-15T02:15:59.000Z","size":213,"stargazers_count":31,"open_issues_count":4,"forks_count":21,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-04T07:01:55.685Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NodeBB-Community.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2015-06-27T20:11:43.000Z","updated_at":"2025-04-30T03:06:16.000Z","dependencies_parsed_at":"2024-01-15T20:11:46.329Z","dependency_job_id":"0d2d2e90-6a0b-49c9-aa58-ca3fb37467e1","html_url":"https://github.com/NodeBB-Community/nodebb-plugin-recent-cards","commit_stats":null,"previous_names":["psychobunny/nodebb-plugin-recent-cards"],"tags_count":63,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NodeBB-Community%2Fnodebb-plugin-recent-cards","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NodeBB-Community%2Fnodebb-plugin-recent-cards/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NodeBB-Community%2Fnodebb-plugin-recent-cards/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NodeBB-Community%2Fnodebb-plugin-recent-cards/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NodeBB-Community","download_url":"https://codeload.github.com/NodeBB-Community/nodebb-plugin-recent-cards/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253655783,"owners_count":21943068,"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-08-03T20:00:32.582Z","updated_at":"2025-05-12T00:30:49.436Z","avatar_url":"https://github.com/NodeBB-Community.png","language":"JavaScript","readme":"# Recent Cards plugin for NodeBB's Persona Theme\n\nThis is a plugin that creates a new widget that can be placed on various widget areas. It's inspired by the previous default theme, Lavender, which used Modern UI styling for the category layout.\n\n\n## Installation\n\nInstall via one-click activation in the Admin Control Panel or run the following command:\n\n    npm i nodebb-plugin-recent-cards\n\nThen head over to Admin -\u003e Extend -\u003e Widgets and place the widget. Additional settings can be found at Admin -\u003e Plugins -\u003e Recent Cards and under the individual widget settings.\n\n## Screenshot\n\n![](https://i.imgur.com/r3NKmY1.jpg)\n\n# Standalone installation for external websites (Advanced)\n\nUse this plugin on any external non-nodebb site (ex. Wordpress, etc) to show recent topics from your NodeBB install.\n\n### Header Scripts + Styles\n\nPlace these in the `header` section of your external site, and replace all instances of `{forumURL}` to your forum's URL:\n\n```\n\u003cscript src=\"{forumURL}/plugins/nodebb-plugin-recent-cards/static/bxslider/jquery.bxslider.min.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\nwindow.path_to_nodebb = '{forumURL}';\n\u003c/script\u003e\n\u003cscript src=\"{forumURL}/plugins/nodebb-plugin-recent-cards/static/lib/external.js\"\u003e\u003c/script\u003e\n\u003clink rel=\"stylesheet\" type=\"text/css\" href=\"{forumURL}/plugins/nodebb-plugin-recent-cards/render/style.css\" /\u003e\n\u003clink rel=\"stylesheet\" type=\"text/css\" href=\"{forumURL}/plugins/nodebb-plugin-recent-cards/static/bxslider/jquery.bxslider.css\" /\u003e\n```\n\nIf your external site doesn't have jQuery included, you will have include it above the previous lines. Get the latest jQuery at https://code.jquery.com/\n\nYou should also (optionally) require the jQuery Timeago library in order to display human-readable timestamps:\n\n```\n\u003cscript src=\"https://cdnjs.cloudflare.com/ajax/libs/jquery-timeago/1.6.1/jquery.timeago.min.js\"\u003e\u003c/script\u003e\n```\n\nIf your external site doesn't have Bootstrap included, you will have to include this line as well in your `header`, which is the bare minimum (grid + responsive utilities) required for this plugin:\n\n```\n\u003clink rel=\"stylesheet\" type=\"text/css\" href=\"{forumURL}/plugins/nodebb-plugin-recent-cards/static/external/bootstrap-grid.css\" /\u003e\n```\n\nSimilarly, if your external site does not use FontAwesome, then you will have to include this line as well in order to display category icons:\n\n```\n\u003clink rel=\"stylesheet\" type=\"text/css\" href=\"https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css\" /\u003e\n```\n\n\nFinally, if you need to include the default Persona font to match your external site's recent cards with your forum's, then include this:\n\n```\n\u003clink rel=\"prefetch stylesheet\" href=\"https://fonts.googleapis.com/css?family=Roboto:300,400,500,700\" /\u003e\n```\n\n\n### Body Content\n\nPlace the following code wherever you'd like recent cards to be displayed:\n\n```\n\u003cdiv id=\"nodebb-plugin-recent-cards\"\u003e\u003c/div\u003e\n```\n\n### Configure ACAO in NodeBB\n\nUnder Settings -\u003e Advanced in the NodeBB control panel, add the external site's URL to `Access-Control-Allow-Origin`\n\n### Stuck?\n\nNo problem! Visit https://yourforum.com/admin/plugins/nodebb-plugin-recent-cards/tests/external, which will render the standalone version of the plugin tailored for your website. Keep in mind that this includes all extra scripts and styling that you may not necessarily need if you already have Bootstrap, jQuery, etc. on your external site.\n","funding_links":[],"categories":["Plugins"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNodeBB-Community%2Fnodebb-plugin-recent-cards","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNodeBB-Community%2Fnodebb-plugin-recent-cards","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNodeBB-Community%2Fnodebb-plugin-recent-cards/lists"}