[Feature]: Preparation for WordPress org release by theMasudRana · Pull Request #57 · rtCamp/carousel-kit

theMasudRana · 2026-02-24T09:04:17Z

Description: Prepare the plugin for WordPress.org release

Issue: https://github.com/rtCamp/support/issues/462#issuecomment-3982065178

…s.org distribution

… and bugs metadata

…or plugin structure

…ibution

… feat/prepair-for-wp-org

…t.php for direct access protection

Copilot

Pull request overview

Prepares the Carousel Kit plugin for a WordPress.org release by adding WP.org-required metadata/artifacts, localizing assets, and hardening direct access.

Changes:

Adds WordPress.org packaging assets (readme.txt, .distignore) and localization template (POT) plus an npm script to generate it.
Replaces externally-hosted placeholder images in example patterns with bundled local assets.
Adds direct-access prevention and an index.php “silence is golden” file.

Reviewed changes

Copilot reviewed 10 out of 17 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
readme.txt	Adds WordPress.org readme metadata, description, screenshots, changelog.
package.json	Adds repository/bugs metadata and an i18n POT generation script.
languages/carousel-kit.pot	Adds translation template for strings.
index.php	Adds “silence is golden” index to prevent directory listing.
examples/patterns/logo-showcase.php	Switches pattern images from external placeholders to bundled SVGs.
examples/patterns/hero-carousel.php	Switches hero slides from external placeholders to bundled WEBPs.
examples/data/images/logo-placeholder-*.svg	Adds bundled placeholder logo SVG assets.
composer.json	Removes a production dependency from `require`.
composer.lock	Updates lockfile to reflect removed production dependency.
carousel-kit.php	Updates license header and adds direct access guard.
Makefile	Adjusts dist exclusions (README.md no longer excluded).
.distignore	Adds ignore rules for WordPress.org distribution packaging.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

readme.txt

package.json

Copilot · 2026-03-03T09:34:49Z

composer.json

 	"require": {
-		"php": "^8.2",
-		"scrivo/highlight.php": "^9.18"
+		"php": "^8.2"
 	},


composer.json requires PHP ^8.2, but the plugin header (carousel-kit.php) and readme.txt both declare Requires PHP: 7.4. For WordPress.org, these should be aligned with the actual runtime requirement; either lower composer.json's PHP constraint/platform or bump the plugin/readme requirement to 8.2 if that's the real minimum.

@theMasudRana

Have we tested this plugin with PHP 7.4?
If not, then whichever is the lowest version of PHP you've tested this plugin with, that should be the required PHP version.

@gagan0123, Sorry about that — we haven’t tested this plugin on PHP 7.4, and declaring 7.4 support was my mistake.
We’re keeping the minimum required PHP version at 8.2 (the lowest version currently validated), and our CI is also configured for PHP 8.2.

Got it, checked that the readme.txt was updated for the same, but README.md is still saying 7.4 as min requirement
Ref: https://github.com/rtCamp/carousel-kit/blob/feat/prepair-for-wp-org/README.md#requirements

Thanks for catching that, @gagan0123,
I've updated the README.md as well to reflect PHP 8.2 as the minimum required version.

readme.txt

up1512001

@theMasudRana Added few suggestions.

up1512001 · 2026-03-03T10:10:04Z

carousel-kit.php

@@ -8,14 +8,18 @@
 * Author:      rtCamp
 * Author URI:  https://rtcamp.com
 * Contributors: iamdanih17, immasud


please add rtcamp as well

Added rtcamp as a contributor.

up1512001 · 2026-03-03T10:11:35Z

carousel-kit.php

+	exit; // Exit if accessed directly.
+}
+
 define( 'CAROUSEL_KIT_PATH', untrailingslashit( plugin_dir_path( __FILE__ ) ) );


if possible wrap this all const into function and add namespace to this file.
reference: https://github.com/rtCamp/OneUpdate/blob/e5920c452fffc70a2d7d922a2c80d44ff065a216/oneupdate.php#L29

Thanks for the suggestion — updated this file to use a namespace and moved all plugin constant definitions into a dedicated constants() function (called during bootstrap). Behavior remains the same, but initialization is now cleaner and more consistent with our standards.

up1512001 · 2026-03-03T10:13:45Z

carousel-kit.php

add file exist check if someone downloads from GH then activating this plugin should give admin notice instead of fatal error.

https://github.com/rtCamp/OneAccess/blob/b8ac1e297c90949e98c2a1ad696380c8b033a15c/inc/Autoloader.php#L61

Refactored bootstrap to a dedicated inc/Autoloader.php class and switched loading flow to Autoloader::autoload(). It now handles missing vendor/autoload.php gracefully with admin/network notices and avoids fatal activation errors.

up1512001 · 2026-03-03T10:15:21Z

package.json

I suggest to remove version from composer & package file to avoid maintaining it on multiple places.

Removed the version from package.json and package-lock.json
Plugin version is not added in the composer.json file.

up1512001 · 2026-03-03T10:18:34Z

readme.txt

+3. Query Loop integration for dynamic content
+4. Frontend carousel with autoplay
+
+== Changelog ==


in plugin root we should have CHANGELOG.md https://github.com/rtCamp/godam/blob/main/CHANGELOG.md

and add just reference of that be adding at latest 2 release info

https://github.com/rtCamp/godam/blob/2456c02e667587571eb8be45f3df8f9d55e449f3/readme.txt#L247C1-L300C83

We have the CHANGELOG.md file in the plugin root.
Added the full changelog reference at the end of the current changelog.

@up1512001

The CHANGELOG.md file has been in the branch for more than a week, why you were not able to find it?

@gagan0123 I was just saying for public plugins in readme.txt we should only include 2-3 latest changelog and at end mention our CHANGELOG.md file so that readme.txt don't get too big and it will save copy-paste work.

up1512001 · 2026-03-03T10:19:22Z

readme.txt

+* Query Loop integration
+* RTL and accessibility support
+
+== Upgrade Notice ==


upgrade notice should be for latest plugin version and if its doing any breaking changes.

https://wordpress.org/plugins/readme.txt#:~:text=%3D%3D%20Upgrade%20Notice%20%3D%3D

https://wp-kama.com/handbook/plugin/wordpress-org/readme-txt#upgrade-notice

Removed the upgrade notice section because we have not published any breaking changes, as per recommendation we don't need this.

…d changelog entries for fixes

…n header

…nitions

…ectory

…tions in tests

…opment files

up1512001

Minor Nits:

up1512001 · 2026-03-05T15:52:01Z

composer.json

-		"test": "phpunit",
-		"test:unit": "phpunit --testsuite unit",
-		"test:coverage": "phpunit --coverage-html tests/_output/coverage"
+		"format": "vendor/bin/phpcbf",


why vendor prefix added??

The vendor/bin/ prefix was added to ensure the scripts could resolve the correct binary paths explicitly. However, this was unnecessary — Composer automatically prepends vendor/bin to the PATH when executing scripts, so bare binary names work just fine. It has been removed to keep the scripts cleaner.

up1512001 · 2026-03-05T15:52:57Z

phpstan.neon.dist

@@ -21,15 +21,14 @@ parameters:
 				- tests/phpstan/constants.php
 		paths:


add uninstall.php

@up1512001 Added the uninstall.php as recommended.

https://github.com/rtCamp/carousel-kit/blob/22cb27cab704d3531e61b2c7351899470fd973f5/uninstall.php

…ionality

…ION, and readme.txt

… svgo and immutable versions

up1512001

@theMasudRana few nits, then good to go from my end 😄

up1512001 · 2026-03-06T06:31:31Z

docs/INSTALLATION.md

Link seems to be incorrect https://github.com/rtCamp/carousel-system-interactivity-api/releases

Updated the link.

up1512001 · 2026-03-06T06:36:17Z

package.json

    "@types/wordpress__block-editor": "15.0.0",
    "@types/wordpress__blocks": "12.5.18",
-    "@wordpress/scripts": "^31.2.0",
+    "@wordpress/scripts": "31.5.0",


any reason to version lock & not allowing minor/patch version updates??

was anything breaking?

Good catch! No, nothing was breaking - it was just inconsistent.
Updated packages to use ^ for semver ranges now.

up1512001 · 2026-03-06T06:42:10Z

phpstan.neon.dist

 				- vendor/
 			analyseAndScan:
-				- node_modules (?)
+				- node_modules/


node_modules might not always exists so would prefer ? instead of /

Added (?) for node_modules

…exclusion in phpstan.neon.dist

theMasudRana added 6 commits February 24, 2026 15:01

chore: remove unused dependency scrivo/highlight.php from composer files

deaef43

feat: add .distignore file to exclude unnecessary files from WordPres…

2760527

…s.org distribution

feat: add localization support and update package.json for repository…

2268cb8

… and bugs metadata

feat: add readme.txt with plugin details and installation instructions

e8cdd4a

feat: update license and version in carousel-kit.php; add index.php f…

4e5fe9f

…or plugin structure

feat: add screenshot for plugin preview in WordPress.org

c3826fc

theMasudRana self-assigned this Feb 24, 2026

theMasudRana added 2 commits February 24, 2026 19:03

feat: update .distignore to refine exclusions for WordPress.org distr…

c4e35cd

…ibution

Merge branch 'develop' of https://github.com/rtCamp/carousel-kit into…

11ae3a9

… feat/prepair-for-wp-org

theMasudRana requested review from danish17 and removed request for danish17 February 26, 2026 13:53

theMasudRana added 4 commits March 2, 2026 19:50

Merge branch 'develop' of https://github.com/rtCamp/carousel-kit into…

712f3b4

… feat/prepair-for-wp-org

feat: add placeholder logos and update hero carousel pattern

bdd4b52

feat: update .distignore to exclude README.md and enhance carousel-ki…

e5ee596

…t.php for direct access protection

feat: Updated pot file

cd5e061

theMasudRana marked this pull request as ready for review March 2, 2026 14:32

theMasudRana requested review from danish17, gagan0123 and up1512001 March 2, 2026 14:35

up1512001 requested a review from Copilot March 3, 2026 09:30

Copilot started reviewing on behalf of up1512001 March 3, 2026 09:30 View session

Copilot AI reviewed Mar 3, 2026

View reviewed changes

up1512001 reviewed Mar 3, 2026

View reviewed changes

theMasudRana added 7 commits March 4, 2026 01:29

feat: update PHP requirement to 8.2, bump stable tag to 1.0.3, and ad…

e32acaf

…d changelog entries for fixes

chore: format package.json for consistency in spacing

acd5906

chore: remove upgrade notice section from readme.txt

bd25e48

chore: remove version field from package.json

49ac3b2

feat: update PHP requirement to 8.2 and reorder contributors in plugi…

3a52e05

…n header

chore: remove version field from package-lock.json

3deb4aa

docs: add link to full changelog in readme.txt

65a5190

theMasudRana added 6 commits March 4, 2026 02:13

docs: add link to full changelog in readme.txt

65a5190

chore: remove version field from package-lock.json

fceb313

fix: update file paths in phpcs and phpstan configuration

4077c28

feat: implement autoloader for PHP classes and refactor constant defi…

a0a1b45

…nitions

fix: ignore phpcs warning for including pattern file from a fixed dir…

02d49a7

…ectory

fix: update script paths in composer.json and improve constant defini…

9c73548

…tions in tests

theMasudRana requested a review from up1512001 March 3, 2026 21:47

theMasudRana added 8 commits March 4, 2026 04:00

fix: update POT-Creation-Date and add missing autoloader error message

3bdc9e0

chore: update @wordpress/scripts to version 31.5.0

08e51fd

feat: add new screenshot image and remove outdated PNG file

e1b9e23

fix: clean up .distignore by removing unnecessary files and directories

353646b

fix: remove outdated screenshots description from readme

7ffdd9a

fix: update dist target to exclude additional configuration and devel…

71381db

…opment files

fix: ensure direct access to Autoloader.php exits gracefully

d33bf17

fix: update package dependencies for minimatch and serialize-javascript

6a05ac9

up1512001 reviewed Mar 5, 2026

View reviewed changes

theMasudRana added 4 commits March 6, 2026 01:17

fix: update script paths in composer.json to use local binaries

46f0f7a

feat: update README with minimum requirements and add uninstall funct…

22cb27c

…ionality

fix: update WordPress minimum requirement to 6.6 in README, INSTALLAT…

320a3ec

…ION, and readme.txt

fix: update contributors list in plugin header and readme.txt

295b2b3

theMasudRana requested a review from up1512001 March 5, 2026 20:38

fix: update package-lock.json to remove unused dependency and upgrade…

c9e877d

… svgo and immutable versions

up1512001 reviewed Mar 6, 2026

View reviewed changes

theMasudRana added 3 commits March 6, 2026 13:14

fix: update tested up to version in readme.txt from 6.9.1 to 6.9

6a23832

fix: correct release link in INSTALLATION.md and update node_modules …

1eea8d8

…exclusion in phpstan.neon.dist

fix: update @wordpress/scripts version to allow minor updates

03ce762

		@@ -21,15 +21,14 @@ parameters:
		- tests/phpstan/constants.php
		paths:

Conversation

theMasudRana commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

up1512001 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

up1512001 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

up1512001 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

theMasudRana commented Feb 24, 2026 •

edited

Loading