{"id":16413821,"url":"https://github.com/smartstore/solutiontemplate","last_synced_at":"2025-04-23T04:36:03.911Z","repository":{"id":83642298,"uuid":"300616648","full_name":"smartstore/SolutionTemplate","owner":"smartstore","description":"Repository","archived":false,"fork":false,"pushed_at":"2020-10-08T18:49:33.000Z","size":115,"stargazers_count":2,"open_issues_count":1,"forks_count":10,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T07:41:22.370Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smartstore.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":"2020-10-02T13:04:26.000Z","updated_at":"2022-02-03T11:09:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"1de39b55-85c0-4691-b6f3-326dfea3833d","html_url":"https://github.com/smartstore/SolutionTemplate","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartstore%2FSolutionTemplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartstore%2FSolutionTemplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartstore%2FSolutionTemplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartstore%2FSolutionTemplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smartstore","download_url":"https://codeload.github.com/smartstore/SolutionTemplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250372379,"owners_count":21419718,"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-10-11T06:52:26.681Z","updated_at":"2025-04-23T04:36:03.893Z","avatar_url":"https://github.com/smartstore.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Smartstore Solution Template\n\nThis repository enables developers to work in a perfect development environment for developing plugins, tests or themes, inclusive every conceivable deployment scenario. \n\n## Quick start ##\n\nTo get a quick insight into plugin \u0026 theme development in private repositories, follow the steps below. \n\n1. Fork this repository\n2. Pull submodules SmartStoreNET \u0026 extra-plugins\n3. Run \\SmartStoreDEV\\create-symlinks.bat\n4. Run \\SmartStoreDEV\\extra-plugins\\create-symlinks.bat\n5. Open solution via symlink directly in Visual Studio \\SmartStoreDEV\\SmartStoreNET\\src\\SmartStoreNET.Dev-sym.sln\n(since loading projects in visual studio via context menu is not working correctly when using symlinks)\n6. Right click solution *SmartStoreNET.Dev-sym* within Visual Studio and select *Restore NuGet Packages*\n7. Set *SmartStore.Web* as Startup project\n8. Build and Run your solution\n\nResult:\n\n1. A non-public plugin that resides in this private repository (Solution \u003e Plugin \u003e MyPlugins)\n2. A non-public theme that is located in this private repository (Solution \u003e SmartStore.Web \u003e Themes \u003e CMS)\n\n## Commercial plugins ##\n\nIf you have purchased a valid Smartstore licence, you will receive updated plugins for the current version with every release of Smartstore. Copy them into the *commercial-plugins* folder and execute the file *create-symlinks.bat* contained in it. The plugins are now available in the local shop where development is taking place. \nAs these plugins are not open source, they have not been added to the solution and cannot be edited.\n\nEvery time you add a new plugin to this folder, e.g. because you bought one in the marketplace or new ones were added by a Smartstore release, the batch file has to be executed again to reference the newly added plugins with a symlink.\n\n## Plugin development ##\n\nIf you want to develop a plugin in your private repository, proceed as follows.\n \n1. Create the plugin project. At this point, our [VS extension](https://marketplace.visualstudio.com/items?itemName=SmartStoreAG.Smartstore) should be mentioned, which allows you to create plugins for Smartstore quickly and effectively\n2. The physical location for your plugin is \\SmartStoreDEV\\src\\Plugins\n3. Open the file *create-symlinks.bat* with a text editor and add the name of the plugin folder to it.\n\nIf, for example, the following was written before:\n\n\tset linkedplugins=SmartStore.HelloWorld, SmartStore.HelloWorld2\n\nIf your plugin is called SmartStore.HelloWorld3, the edited line will looks like this:\n\n    set linkedplugins=SmartStore.HelloWorld, SmartStore.HelloWorld2, SmartStore.HelloWorld3\n\n4. Execute the batch file. A symlink has now been created in the folder \\SmartStoreDEV\\SmartStoreNET\\src\\Plugins. With this symlink the complete plugin project is available in the solution, executable and can be debugged although it is physically out of reach.\n\n5. Add the new project to the solution via this symlink  \n\n## Theme development (without MVC project) ##\n\nThis repository contains a simple example theme (CMS) to better illustrate the development process. This theme must first be added to the solution in **SmartStore.Web \u003e Themes \u003e CMS \u003e [Context menu] \u003e *Include In Project***.\n\nYou can read more about the development of themes [here](http://docs.smartstore.com/display/SMNET/How+to+write+a+Theme#space-menu-link-content).\n\n## Build solution ##\n\nTo create your solution, inclusive all purchased plugins (from the *commercial-plugins* folder) and all self-developed plugins, execute the file *build-with-plugins.cmd*. This file creates the entire shop and copies it into the folder: \\SmartStoreDEV\\SmartStoreNET\\build\\Web. This folder can now be loaded onto the server.\n\nExecute *build-with-plugins-zip.cmd* if you also want to create a zip file from the folder.\n\nIf you are using your own theme that is to be created by the build process, you must first enter the folder name of your theme in the SmartStoreNET.Dev.proj file (line 11) in the *ThemeName* node. Execute the file *build-full.cmd* or *build-full-zip.cmd* to create the shop including all plugins and your theme.\n\nIf you would like to create your theme in your own MVC project, please take a closer look at the target node *DeployTheme* in the file *SmartStoreNET.Dev.proj* and change the lines commented out according to your requirements.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartstore%2Fsolutiontemplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmartstore%2Fsolutiontemplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartstore%2Fsolutiontemplate/lists"}