{"id":43405228,"url":"https://github.com/findologic/plugin-plentymarkets-ceres-api","last_synced_at":"2026-02-02T15:52:59.805Z","repository":{"id":37695804,"uuid":"119961157","full_name":"findologic/plugin-plentymarkets-ceres-api","owner":"findologic","description":"Findologic API plugin for plentymarkets Ceres","archived":false,"fork":false,"pushed_at":"2024-04-08T08:53:24.000Z","size":13958,"stargazers_count":1,"open_issues_count":5,"forks_count":3,"subscribers_count":6,"default_branch":"develop","last_synced_at":"2024-04-08T10:04:53.783Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://marketplace.plentymarkets.com/plugins/individualisierung/shop-erweiterungen/findologic_6390","language":"PHP","has_issues":true,"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/findologic.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":"2018-02-02T09:25:39.000Z","updated_at":"2024-04-15T08:41:18.658Z","dependencies_parsed_at":"2024-01-10T08:44:32.228Z","dependency_job_id":"7944f0e4-808e-45bf-8e25-4343976ac0ec","html_url":"https://github.com/findologic/plugin-plentymarkets-ceres-api","commit_stats":null,"previous_names":[],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/findologic/plugin-plentymarkets-ceres-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/findologic%2Fplugin-plentymarkets-ceres-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/findologic%2Fplugin-plentymarkets-ceres-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/findologic%2Fplugin-plentymarkets-ceres-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/findologic%2Fplugin-plentymarkets-ceres-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/findologic","download_url":"https://codeload.github.com/findologic/plugin-plentymarkets-ceres-api/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/findologic%2Fplugin-plentymarkets-ceres-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29014904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-02T14:58:54.169Z","status":"ssl_error","status_checked_at":"2026-02-02T14:58:51.285Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2026-02-02T15:52:58.426Z","updated_at":"2026-02-02T15:52:59.794Z","avatar_url":"https://github.com/findologic.png","language":"PHP","readme":"# Findologic API plugin for Plentymarkets Ceres\n[![Build Status](https://travis-ci.org/findologic/plugin-plentymarkets-ceres-api.svg?branch=development)](https://travis-ci.org/findologic/plugin-plentymarkets-ceres-api)\n\n## Table of Contents\n\n1. [Setup](#setup)\n   1. [Prerequisites](#prerequisites)\n   1. [Installation](#installation)\n1. [Development](#development)\n   1. [Installing dependencies](#installing-dependencies)\n   1. [Development cycle](#development-cycle)\n      1. [Initial Setup](#initial-setup)\n      1. [Building non-compiled files](#building-non-compiled-files)\n   1. [Running unit-tests locally](#running-unit-tests-locally)\n1. [Deployment \u0026 Release](#deployment--release)\n1. [Versioning](#versioning)\n\n## Setup\n\n### Prerequisites\n\nInstallation of Plentymarkets plugins:\n\n* [Ceres](https://marketplace.plentymarkets.com/ceres_4697) \u003e= 5.0.35\n* [IO](https://marketplace.plentymarkets.com/io_4696) \u003e= 5.0.35\n\n### Installation\n\nFor development install the Findologic plugin in the Plentymarkets backend via Git.\nFor production install the Findologic plugin via the [Plentymarkets marketplace](https://marketplace.plentymarkets.com/findologic_6390).\n\n\u003e Note: In the Plentymarkets Backend you have the possibility to change the code of your plugin but this only works if\nthe plugin has been installed via the marketplace.\n\n## Development\n\nPlentymarkets is a cloud hosted shop system, this means that it's not possible to setup on a local machine.\nCreate separate plugin sets in the Plentymarkets for development or debugging purposes.\n\n### Requirements\n* PHP 7.1, 7.2 or 7.3 (7.4 and greater **is not supported**)\n* Composer\n* nodejs 16\n* npm 8\n\n### Installing dependencies\n\nInstall PHP dependencies:\n```bash\ncomposer install\n```\n\nInstall JS dependencies:\n```\nnpm install\n```\n\n### Development cycle\n\n### Initial Setup\n\nBefore you can start developing, download the [PlentyDevTool](https://marketplace.plentymarkets.com/plenty-tools/plentydevtool_6652).\nIt is available for Windows, Linux and MacOS. This tool allows us to change files locally\nand let Plenty update it for us automatically.\n\nStart the downloaded program. If you run Linux, you may need to give it execution\npermission with `chmod +x PlentyDevTool-1.1.5.AppImage`. Log in with your Plentymarkets credentials.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_login.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_login.png)\n\nCreate a new folder, where you will save all plugins from your plugin-sets. Something like\n`~/Documents/plentyDevTool` should be sufficient. Select this folder in your PlentyDevTool.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_folder.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_folder.png)\n\nIn the Plentymarkets Backend create a new Plugin-Set that **only** contains **Ceres** and **IO**.\nThis Plugin-Set **must not be linked with any store**, otherwise automatic deployment **does not work**.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_backend_ceres_io.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_backend_ceres_io.png)\n\nBack in the PlentyDevTool go to the *Dashboard* and *Reload* the Plugin-Set list.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_reload.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_reload.png)\n\nOn the left side open your Plugin-Set and check the *Ceres* and *IO* plugin and then click on *Pull*.\nThe initial pull may take some time, feel free to get a ☕ coffee in the meantime.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_pulling.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_pulling.png)\n\nNow that everything is setup, clone this repo inside of the Plugin-Set path.\nThe path may be `~/Documents/plentyDevTool/34185/2`. The cloned repository name\n**must be Findologic**, otherwise will not be recognized by the PlentyDevTool.\n\n```bash\ngit clone git@github.com:findologic/plugin-plentymarkets-ceres-api.git Findologic\n```\n\nNow clicking *Detect new local plugins* in the PlentyDevTool should show the\nFindologic plugin in the list. Click *Install*, which will upload your local plugin.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_install_plugin.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_dev_tool_install_plugin.png)\n\nRefresh the Plugin-Sets in the PlentyDevTool and ensure to check the *Findologic* plugin\nnow and uncheck *Ceres* and *IO*. This tells Plentymarkets to only check for file\nchanges in the Findologic plugin.\n\nNext refresh the Plugin-Set page in the browser and activate the newly added Findologic\nplugin. Follow the [configuration instructions](https://docs.findologic.com/doku.php?id=integration_documentation:plentymarkets_ceres_plugin:ceres_plugin_configuration)\nin our documentation and deploy the Plugin-Set.\n\n![https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_backend_deploy.png](https://raw.githubusercontent.com/findologic/plugin-plentymarkets-ceres-api/develop/meta/docs/images/plenty_backend_deploy.png)\n\nWhen files are now changed, the PlentyDevTool will automatically detect them and allow you to\npush your changes. Once pushed Plentymarkets will automatically trigger a build, that only\nbuilds your changes, which makes it an almost immediate change.\nFrom the [PlentyDevTool description](https://marketplace.plentymarkets.com/en/plentydevtool_6652):\n\n\u003e Warning:\n\u003e The auto build is an abbreviated build. It only checks the files changed, but does not validate how\n\u003e they interact with other files. Consequently, the auto build may not show errors that would become\n\u003e apparent in the manual build.\n\n### Building non-compiled files\n\nBefore pushing you may run build to ensure your JS/CSS is built.\n\n```\nnpm run build\n```\n\n### Local TS and Vue development\n\nWhen developing you can also run a local test server, where your compiled JS and CSS is being fetched from your local system. The following things have to be done in order to serve files locally:\n\n* Start local development server\n   * This will install local SSL certificates on first start\n* Update views to serve files locally\n* Accept certificates in your browser\n\n**Starting local development server**\n\nYou can start your local development server anytime with this command.\n\n```bash\nnpm run serve\n```\n\n**Serve files locally**\n\nIn order to serve the files locally, simply update the views responsible for loading them.\n\n**`resources/views/content/scripts.twig`**\n\n```twig\n{# Old #}\n\u003cscript src=\"{{ plugin_path(\"Findologic\") }}/js/dist/findologic_ceres.js\"\u003e\u003c/script\u003e\n\n{# Replace old with this #}\n\u003cscript src=\"https://localhost:5173/resources/js/dist/findologic_ceres.js\"\u003e\u003c/script\u003e\n```\n\n**`resources/views/content/styles.twig`**\n\n```twig\n{# Old #}\n\u003clink rel=\"stylesheet\" href=\"{{ plugin_path(\"Findologic\") }}/js/dist/findologic_ceres.css\" /\u003e\n\n{# Replace old with this #}\n\u003clink rel=\"stylesheet\" href=\"https://localhost:5173/resources/js/dist/findologic_ceres.css\" /\u003e\n```\n\nPush these changes to your Plugin-Set using the PlentyDevTool.\n\n**Accept certificates in your browser**\n\nOpen https://localhost:5173/ and accept the certificates.\n\n### Running unit-tests locally\n\nMake sure to include the `tests/phpunit.xml` as an *alternative configuration file* in your IDE.\n\nAlternatively run all tests with\n\n```\ncomposer test\n```\n\n## Deployment \u0026 Release\n1. Update the German and English change logs in folder `meta/documents`.\n1. Bump the plugin version in files `plugin.json` and `src/Constants/Plugin.php`.\n1. Open the backend from our Plentymarkets shop.\n1. Go to *Plugins \u003e Plugin overview \u003e Plugin Release \u003e Findologic \u003e Git* and fetch \u0026 pull the `main` branch.\n1. Go back to *Plugin overview* and click *Save \u0026 deploy plugin set*.\n1. Open the plugin again and click on *Upload to plentyMarketplace*.\n1. The plugin may not be available yet, Plentymarkets has to do a review on their side.\n1. After review was successful notify colleagues in #releases.\n\n## Versioning\n\nWe use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/findologic/plugin-plentymarkets-ceres-api/tags). \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffindologic%2Fplugin-plentymarkets-ceres-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffindologic%2Fplugin-plentymarkets-ceres-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffindologic%2Fplugin-plentymarkets-ceres-api/lists"}