{"id":18156227,"url":"https://github.com/wpfedora/wordpress-fedora","last_synced_at":"2025-08-22T13:30:52.886Z","repository":{"id":258082733,"uuid":"866788253","full_name":"WPFedora/WordPress-Fedora","owner":"WPFedora","description":"WordPress Fedora is a custom-built distribution of WordPress, designed for SEO professionals and advanced users who seek a streamlined and efficient environment tailored specifically for optimizing and managing SEO-driven websites.","archived":false,"fork":false,"pushed_at":"2024-10-30T20:06:49.000Z","size":21885,"stargazers_count":4,"open_issues_count":5,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-02T05:05:44.299Z","etag":null,"topics":["wordpress","wordpress-php-library","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://wpfedora.com","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WPFedora.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,"publiccode":null,"codemeta":null}},"created_at":"2024-10-02T21:53:01.000Z","updated_at":"2024-11-01T18:22:52.000Z","dependencies_parsed_at":"2024-10-26T23:36:03.239Z","dependency_job_id":null,"html_url":"https://github.com/WPFedora/WordPress-Fedora","commit_stats":null,"previous_names":["wpfedora/wordpress-fedora"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WPFedora%2FWordPress-Fedora","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WPFedora%2FWordPress-Fedora/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WPFedora%2FWordPress-Fedora/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WPFedora%2FWordPress-Fedora/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WPFedora","download_url":"https://codeload.github.com/WPFedora/WordPress-Fedora/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230596265,"owners_count":18250855,"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":["wordpress","wordpress-php-library","wordpress-plugin"],"created_at":"2024-11-02T05:05:46.768Z","updated_at":"2024-12-20T14:13:18.243Z","avatar_url":"https://github.com/WPFedora.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n![image](_repo/cover-image.jpg)\n\n# WordPress Fedora Plugin\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp align=\"center\"\u003e\n   WP Fedora is a powerful, performance-optimized WordPress distro designed specifically for SEOs. Our community is dedicated to helping SEO professionals maximize their WordPress sites through WP Fedora, and it's available built-in tools and utilities.\n   \u003cbr /\u003e\n   \u003cbr /\u003e\n   \u003ca href=\"https://github.com/WPFedora/WordPress-Fedora/issues/new?assignees=\u0026labels=bug%2Cpending+triage\u0026projects=\u0026template=bug_report.yaml\"\u003eReport Bug\u003c/a\u003e\n   \u0026middot;\n   \u003ca href=\"https://github.com/WPFedora/WordPress-Fedora/issues/new?assignees=\u0026labels=enhancement%2Cpending+triage\u0026projects=\u0026template=feature_request.yaml\"\u003eFeature Request\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#build-logic\"\u003eBuild Logic\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n### Built With\n\n- [Node Version Manager (NVM)](https://github.com/nvm-sh/nvm)\n- [Node.js](https://nodejs.org/)\n- [Vite](https://vite.dev/)\n- [SASS/SCSS](https://sass-lang.com/)\n- [Gulp.js](https://gulpjs.com/)\n- [ESLint](https://eslint.org/)\n- [Prettier](https://prettier.io/)\n- [Warp Terminal](https://warp.dev)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\nAll plugin files live inside of the `/src` folder. These are the instructions on setting up your project locally. To get a local copy up and running follow these simple steps.\n\n### Prerequisites\n\nFor all of the awesome people using Node Version Manager (NVM) instead of Node.js, we have an `.nvmrc` file in the repo. For everyone else, please check this file to make sure that your Node.js version matches.\n\n- Switch to correct Node.js Version\n\n```zsh\nnvm use\n```\n\n### Installation\n\n1. Clone the repo.\n   ```sh\n   git clone https://github.com/WPFedora/WordPress-Fedora.git\n   ```\n2. Install NPM packages.\n   ```zsh\n   npm install\n   ```\n3. Run the start command to watch and build files.\n\n```zsh\nnpm run start:dev\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- USAGE EXAMPLES --\u003e\n\n## Usage\n\nBelow, you will find our common commands and notes for general usage.\n\n1. Run `npm run build:dev`.\n   - When you build in dev, the plugin folder **IS NOT ZIPPED**. This is for those situations where you're working with local instance of WordPress using XAMP, LAMP, MAMP, etc. or even the LocalWP tool (which we use). Those steps are:\n     - Build the new plugin folder.\n     - Delete the current folder in your WP website.\n     - Copy your new plugin folder into the website's plugins folder.\n2. Run `npm run build:plugin`.\n\n   - When you build the plugin, the plugin folder **IS ZIPPED** and ready for upload to a WP website.\n\n3. Run `npm run start:dev`.\n\n   - This is runs the default `vite` command. The terminal will tell you to open the browser to a `localhost` port. **We do not use the browser.**\n   - A custom hot reload plugin is located in the Vite config file to watch all files in the `/src` folder.\n   - Each time a file is changed, the hot reload will trigger a `npm run build:dev`.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- BUILD PROCESS LOGIC --\u003e\n\n## Build Logic\n\n### Vite Build\n\nVite will convert all of your `.scss` to `.css`. These files, along with all `.js` files, will all be placed in a `/dist` folder.\n\n### Build Plugin Core\n\nThis covers the series of tasks that are used to initially build the plugin folder. Found in both `build:dev` and `build:plugin` scripts.\n\n1. create-plugin-folders\n\n   - This will check to see if folders `wp-fedora-core` and `wp-fedora-core/wp-fedora` both exist. If not, they will be created.\n\n2. copy-php-to-plugin-folder\n\n   - This copies the `php` folder over to `wp-fedora-core/wp-fedora`.\n\n3. copy-assets-from-dist-to-plugin-folder\n\n   - This copies the `assets` folder from `dist/assets` over to `wp-fedora-core/wp-fedora/assets`.\n\n4. copy-img-to-plugin-assets\n\n   - This copies the `img` folder from `src/assets/img` over to `wp-fedora-core/wp-fedora/assets/img`.\n\n5. copy-xsl-to-plugin-assets\n\n   - This copies the `*.xsl` file from `src/**/*` (which is where the sitemap file is located) over to `wp-fedora-core/wp-fedora/assets`.\n\n6. move-wp-fedora-core-php\n\n   - When the `php` is copied over, the `wp-fedora-core.php` file gets put into the `wp-fedora-core/wp-fedora` folder. This task will move it up one level to the `wp-fedora-core` folder.\n\n7. convert-php-encoding\n\n   - With Vite, the PHP files don't get the correct file encoding. This step properly converts them to `utf-8` for WordPress.\n\n8. delete-empty-folders\n\n   - This will recursively delete all empty folders from the parent plugin folder `wp-fedora-core`.\n\n9. zip-plugin-core\n\n   - This will zip up folder `wp-fedora-core` and name the new zip `wp-fedora-core.zip`.\n\n### Build WordPress Distro\n\n1. download-latest-wordpress-zip\n\n   - This will go to the [WordPress repo](https://github.com/WordPress/WordPress) and identify the latest version number.\n   - Then it will download the latest WP version.\n\n2. unzip-wordpress\n\n   - This will unzip the latest WP version that we just downloaded. The folder name does not change.\n\n3. create-mu-plugins-folder\n\n   - Inside the WP folder that we just unzipped, this will create a new folder under `wp-content` called `mu-plugins`.\n\n4. copy-plugin-to-mu-plugins\n\n   - All of our plugin files inside of `wp-fedora-core` will be copied over to the newly created `mu-plugins` folder.\n\n5. zip-wordpress-distro\n\n   - The updated WP files will get zipped back up, and renamed to `WordPress-Fedora-[version].zip`.\n\n### Cleanup Plugin\n\nThis covers the series of tasks that are used to clean up the plugin folder after the zip file is created. Found in the `build:dev`, `build:plugin` and `build:wordpress` scripts.\n\n1. delete-plugin-build-folders\n\n   - Delete the `/dist` folder that is generated by Vite.\n   - Delete the plugin folder (i.e., `/wp-fedora-core`).\n\n### Cleanup Distro\n\nThis covers the series of tasks that are used to clean up the WordPress folders after the WP Fedora distro is created. Found in the `build:wordpress` script.\n\n1. delete-wordpress-build-folders\n   - Delete the WordPress release folder (i.e., `/WordPress-6.6.2`).\n   - Delete the WordPress zip file (i.e., `/WordPress-6.6.2.zip`).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ROADMAP --\u003e\n\n## Roadmap\n\nWe don't have a dedicated roadmap outside of Github. Simply check the [open issues](https://github.com/WPFedora/WordPress-Fedora/issues) for a full list of proposed features (and known issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\". Don't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License. See `LICENSE.md` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n\n## Acknowledgments\n\nWithout these people and tools, life would be too complicated.\n\n- Good food.\n- Good company.\n- Good tools.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/WPFedora/WordPress-Fedora.svg?style=for-the-badge\n[contributors-url]: https://github.com/WPFedora/WordPress-Fedora/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/WPFedora/WordPress-Fedora.svg?style=for-the-badge\n[forks-url]: https://github.com/WPFedora/WordPress-Fedora/network/members\n[stars-shield]: https://img.shields.io/github/stars/WPFedora/WordPress-Fedora.svg?style=for-the-badge\n[stars-url]: https://github.com/WPFedora/WordPress-Fedora/stargazers\n[issues-shield]: https://img.shields.io/github/issues/WPFedora/WordPress-Fedora.svg?style=for-the-badge\n[issues-url]: https://github.com/WPFedora/WordPress-Fedora/issues\n[license-shield]: https://img.shields.io/github/license/WPFedora/WordPress-Fedora.svg?style=for-the-badge\n[license-url]: https://github.com/WPFedora/WordPress-Fedora/blob/main/license.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwpfedora%2Fwordpress-fedora","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwpfedora%2Fwordpress-fedora","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwpfedora%2Fwordpress-fedora/lists"}