Skip to content
This repository was archived by the owner on Nov 19, 2024. It is now read-only.

Commit 32b5779

Browse files
authored
Marketplace Migration - Sellers (#6743)
* Update main-nav.yml Added Extension Marketplace to Functional Areas * Create marketplace-sellers.yml Created the TOC for Marketplace Seller Guide * Uploaded Marketplace images Uploaded to extensions/marketplace/images folder. * Marketplace content Uploaded all content files for the sellers' guide. * Update marketplace-sellers.yml Updated listings and added Packaging v1 extensions and Reference, * Content files Updated meta data with group and to remove old redirects; updated links and misc edits. * Added icon images Uloaded icons to images/assets folder. * Update account-overview.md Fixed typo in link. * Update before-you-begin.md Fixed filenames in links. * Update developer-register.md Removed target=blank; fixed paths * Delete extension-build.md This topic is not needed. * Update extension-complete.md Fixed typo in filename. * Update extension-quality-program.md Fixed filename in link. * Updated links Updated links for renamed files. * Update main-nav.yml Added versionless * Renamed Getting Started Renamed Getting Started to index.html * Update packaging-v1x-extensions.md fixed typo in meta data * Update seller-overview.md fixed link. * Updated TOCs getting-started.html is now index.html; added Seller Overview; added Marketplace Tools * Changed TOC entries Changed to match topic titles. * Misc edits Removed blank line between bullet items; fixed capitalization of headers * Misc edits Changed link format, fixed header capitalization * Misc edits Mostly space after bullets. * Misc Formatting Removed indentation from bullets in an ordered list, * Misc edits Trailing spaces; list indents * Misc edits space after bullet * Update revenue-share.md Removed target. * Update video-tips.md Removed slash (\) * Update test-module.md Updated link to user guide. * Update packages.md Updated link to EQP topic. * Update marketplace-sellers.yml Added versionless: true to children in TOC * Update marketplace-sellers.yml Fixed filename in toc. * Update marketplace.md Updated link. * Update marketplace-sellers.yml Added versionless: true * Create reports.md Replaced file that was accidentally deleted. * Renamed getting-started.md changed from index.md * Updated navigation for getting-started.md rather than index.md * Create grid.html grid layout with tiles. * Landing pages with tiles Removed extra space after bullet (hyphen) * Icon images Adjusted size of some to make them the same; added tools icon,. * Update getting-started.md Replaced meta section data with image table. * Update seller-overview.md Replaced meta section data with image table. * Update extensions.md Reworked separeate tables into one; moved image higher on page. * Update purchase.png Resized icon to it's the same width as others. * Update extension-complete.md Changed title to Creqte a New Extension; moved diagram up higher on page. * Removed marketplace tools Thsi github repo is no longer available, and was replaced by Marketplace EQP. * Update tech-review-content.png Increaded the canvas size so it scales the same as the marketing review image. * Moved workflow diagrams Moved these diagrams up higher on the page. * Update marketplace-sellers.yml Fixed typo in toc * Update marketplace-sellers.yml Removed duplicate entry for Code Validation. * Moved content Moved from extensions/marketplace folder to marketplace/sellers. Updated both yml files and all links. * Update marketplace-sellers.yml Minor updates to topic titles and filename changes * Create profile-information.md Changed flename from profile-account.md * Delete profile-account.md Renamed file to profile-information.md * Create extension-create.md Renamed extension-complete.md to extension-create.md * Delete extension-complete.md Renamed extension-complete.md to extension-create.md * Updated links Updated links for renamed files. * Update marketplace-sellers.yml Updated a few titles and filename changes, and moved the Packaging v1.s Extensions to the Technical Reference at the end. Also created a separate section for Complete the Extension Information,. * Fixed redirect syntax Changed the meta redirect to a single line. * Update submit-for-review.md Changed title to Review Process * Renamed file Renamed account-overview.md to account-setup-process.md * Updated link text Changed "Build Your Extension" to "Create an Extension"; Changed "Resources" to "Technical Reference". * Update seller-overview.md updated link * Update review-report.md Fixed redirect format to one line. * Update marketplace-sellers.yml Moved Update Extension Information to new Extension Informaiton section in TOC. * Corrected redirect Removed user_guide from redirect path. * Added FAQ content Incorporated content from the Frequently Asked Questions into related topics.
1 parent 6dfbfe2 commit 32b5779

File tree

113 files changed

+2259
-5
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

113 files changed

+2259
-5
lines changed

src/_data/main-nav.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -218,6 +218,10 @@
218218
url: /compliance/industry-compliance.html
219219
versionless: true
220220

221+
- label: Extensions Marketplace
222+
url: /marketplace/sellers/getting-started.html
223+
versionless: true
224+
221225
- label: Inventory Management
222226
url: /inventory/index.html
223227
exclude_versions: ['2.0', '2.1', '2.2']

src/_data/toc/marketplace-sellers.yml

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
label: Marketplace Sellers
2+
versionless: true
3+
pages:
4+
- label: Getting Started
5+
url: /marketplace/sellers/getting-started.html
6+
versionless: true
7+
children:
8+
9+
- label: Before You Begin
10+
url: /marketplace/sellers/before-you-begin.html
11+
versionless: true
12+
13+
- label: Extension Quality Program
14+
url: /marketplace/sellers/extension-quality-program.html
15+
versionless: true
16+
17+
- label: Seller Overview
18+
url: /marketplace/sellers/seller-overview.html
19+
versionless: true
20+
children:
21+
22+
- label: Your Seller Account
23+
url: /marketplace/sellers/account-setup.html
24+
versionless: true
25+
26+
- label: Account Setup Process
27+
url: /marketplace/sellers/account-setup-process.html
28+
versionless: true
29+
30+
- label: Register as a Developer
31+
url: /marketplace/sellers/developer-register.html
32+
versionless: true
33+
34+
- label: Marketplace Developer Portal
35+
url: /marketplace/sellers/developer-portal.html
36+
versionless: true
37+
children:
38+
39+
- label: Profile Information
40+
url: /marketplace/sellers/profile-information.html
41+
versionless: true
42+
43+
- label: Company Profile
44+
url: /marketplace/sellers/profile-company.html
45+
versionless: true
46+
47+
- label: Personal Profile
48+
url: /marketplace/sellers/profile-personal.html
49+
versionless: true
50+
51+
- label: Extensions
52+
url: /marketplace/sellers/extensions.html
53+
versionless: true
54+
children:
55+
56+
- label: Create an Extension
57+
url: /marketplace/sellers/extension-create.html
58+
versionless: true
59+
60+
- label: Specify the Version
61+
url: /marketplace/sellers/extension-version.html
62+
versionless: true
63+
64+
- label: Complete the Extension Information
65+
url: /marketplace/sellers/extension-information.html
66+
versionless: true
67+
children:
68+
69+
- label: Add Extension Content
70+
url: /marketplace/sellers/content.html
71+
versionless: true
72+
73+
- label: Establish Your Brand
74+
url: /marketplace/sellers/branding.html
75+
versionless: true
76+
77+
- label: Define the Business Value
78+
url: /marketplace/sellers/business-value.html
79+
versionless: true
80+
81+
- label: Update Extension Information
82+
url: /marketplace/sellers/extension-update-information.html
83+
versionless: true
84+
85+
- label: Themes
86+
url: /marketplace/sellers/themes.html
87+
versionless: true
88+
89+
- label: Shared Packages
90+
url: /marketplace/sellers/shared-packages.html
91+
versionless: true
92+
93+
- label: Review Process
94+
url: /marketplace/sellers/submit-for-review.html
95+
versionless: true
96+
97+
- label: Submit for Technical Review
98+
url: /marketplace/sellers/submit-for-technical-review.html
99+
versionless: true
100+
children:
101+
102+
- label: Technical Review Guidelines
103+
url: /marketplace/sellers/technical-review-guidelines.html
104+
versionless: true
105+
106+
- label: Code Validation
107+
url: /marketplace/sellers/code-validation.html
108+
versionless: true
109+
110+
- label: Submit for Marketing Review
111+
url: /marketplace/sellers/submit-for-marketing-review.html
112+
versionless: true
113+
children:
114+
115+
- label: Marketing Review Guidelines
116+
url: /marketplace/sellers/marketing-review-guidelines.html
117+
versionless: true
118+
119+
- label: Product Descriptions
120+
url: /marketplace/sellers/product-descriptions.html
121+
versionless: true
122+
123+
- label: Video Tips
124+
url: /marketplace/sellers/video-tips.html
125+
versionless: true
126+
127+
- label: Image Tips
128+
url: /marketplace/sellers/image-tips.html
129+
versionless: true
130+
131+
- label: Preview Your Submission
132+
url: /marketplace/sellers/marketing-submission-preview.html
133+
versionless: true
134+
135+
- label: View the Results
136+
url: /marketplace/sellers/review-report.html
137+
versionless: true
138+
children:
139+
140+
- label: Resubmit an Extension
141+
url: /marketplace/sellers/extension-resubmit.html
142+
versionless: true
143+
144+
- label: Manage Sales
145+
url: /marketplace/sellers/sales.html
146+
versionless: true
147+
children:
148+
149+
- label: Revenue Share
150+
url: /marketplace/sellers/revenue-share.html
151+
versionless: true
152+
153+
- label: Analytics
154+
url: /marketplace/sellers/analytics.html
155+
versionless: true
156+
157+
- label: Technical Reference
158+
url: /marketplace/sellers/technical-reference.html
159+
versionless: true
160+
children:
161+
162+
- label: Packaging v1.x Extensions
163+
url: /marketplace/sellers/packaging-v1x-extensions.html
164+
versionless: true

src/_includes/grid.html

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<div class="columns {% if include.large %}large-{{include.large}}{% endif %}">
2+
{% for section in include.sections %}
3+
<div class="column">
4+
<a href="{{ site.baseurl }}{{ section.url }}" class="card">
5+
<h3 class="no_toc">{{ section.title }}</h3>
6+
<p>{{ section.content }}</p>
7+
</a>
8+
</div>
9+
{% endfor %}
10+
</div>

src/guides/v2.3/comp-mgr/marketplace/marketplace.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ functional_areas:
99
- Upgrade
1010
---
1111

12-
This topic provides a simple example of getting free extensions for {{site.data.var.ce}}. See the [Marketplace quick tour](https://docs.magento.com/marketplace/user_guide/buyers/install-extension.html).
12+
This topic provides a simple example of getting free extensions for {{site.data.var.ce}}. See the [Magento Marketplace](https://docs.magento.com/m2/ee/user_guide/magento/magento-marketplace.html).
1313

1414
### Log in to Magento Marketplace
1515

src/guides/v2.3/extension-dev-guide/build/composer-integration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ Where:
222222
[2]: https://packagist.org/
223223
[3]: https://getcomposer.org/doc/05-repositories.md#path
224224
[4]: https://www.iso.org/iso-639-language-codes.html
225-
[5]: https://docs.magento.com/marketplace/user_guide/sellers/company-profile.html
225+
[5]: https://docs.magento.com/marketplace/sellers/company-profile.html
226226
[6]: https://marketplace.magento.com/
227227
[7]: https://marketplace.magento.com
228228
[8]: {{ page.baseurl }}/extension-dev-guide/package/package_module.html#package-metapackage

src/guides/v2.3/extension-dev-guide/validate/test-module.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ See these resources for testing in [PHP](https://glossary.magento.com/php) and v
4848
4949
* The [Magento Coding Standard] provides a set of rules and sniffs for the [PHP_CodeSniffer] tool
5050
* [Technical Deep Dive: How to Pass the Magento Marketplace Extension Quality Program] (video) from Magento Imagine 2017
51-
* [Extension Quality Program] in the Magento Marketplace User Guide
51+
* [Extension Quality Program]({% link marketplace/sellers/extension-quality-program.md %}) in the Magento User Guide
5252
* [01 The Module Skeleton Kata] (video) by [Mage2Katas]
5353
5454
[Magento Testing Overview]: {{ page.baseurl }}/test/testing.html
@@ -63,6 +63,5 @@ See these resources for testing in [PHP](https://glossary.magento.com/php) and v
6363
[Magento Coding Standard]: https://github.com/magento/magento-coding-standard
6464
[PHP_CodeSniffer]: https://github.com/squizlabs/PHP_CodeSniffer
6565
[Technical Deep Dive: How to Pass the Magento Marketplace Extension Quality Program]: https://magento.com/resources/technical-deep-dive-how-pass-magento-marketplace-extension-quality-program
66-
[Extension Quality Program]: https://docs.magento.com/marketplace/user_guide/sellers/extension-quality-program.html
6766
[01 The Module Skeleton Kata]: https://www.youtube.com/watch?v=JvBWJ6Lm9MU)
6867
[Mage2Katas]: http://mage2katas.com/

src/marketplace/eqp/v1/packages.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: Packages
44
---
55

66
Use this resource to initiate and manage all aspects of submitting a package to the
7-
[Magento Extension Quality Program (EQP)](http://docs.magento.com/marketplace/user_guide/extensions/extension-quality-program.html).
7+
[Magento Extension Quality Program (EQP)]({% link marketplace/sellers/extension-quality-program.md %}).
88
You can provide all metadata associated with a package, both the technical and the marketing information, in a single step, or in several steps, using incremental updates.
99

1010
* **Technical information** - References to code artifacts, such as Magento 1 TGZ files or Composer-compliant Magento 2 ZIP files, version compatibility, and release notes.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
group: marketplace-sellers
3+
title: Account Setup Process
4+
redirect_from: /marketplace/sellers/set-up-your-account.html
5+
---
6+
7+
## Step 1: Log in or register for a developer account.
8+
9+
If you have an existing Magento account, simply log in and complete the [developer registration]({% link marketplace/sellers/developer-register.md %}) process. If you are new to Magento, you can sign up for a new account and register as a developer at the same time.
10+
11+
## Step 2: Agree to the terms of service.
12+
13+
Read the Magento Marketplace [terms of service](https://magento.com/legal/terms/marketplace-xcelerate). Then, select the checkbox to agree with the terms and continue.
14+
15+
## Step 3: Complete your personal profile.
16+
17+
The information in your [personal profile]({% link marketplace/sellers/developer-register.md %}) identifies you as an individual vendor in Magento Marketplace, and includes your background, image, contact information, and social network addresses.
18+
19+
## Step 4: Complete your company profile.
20+
21+
Your [company profile]({% link marketplace/sellers/developer-register.md %}) is similar to your personal profile, and provides the information about your company and brand that appears in your Magento Marketplace listing.
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
group: marketplace-sellers
3+
title: Set Up Your Developer Account
4+
redirect_from: /marketplace/sellers/account-setup-overview.html
5+
---
6+
7+
Create a new Marketplace account, or use your existing Magento account. Then, use the Marketplace Developer Portal to manage your profile information, product submissions, and the monthly payments you receive from sales on Magento Marketplace.
8+
9+
- [Process overview]({% link marketplace/sellers/account-setup-process.md %})
10+
- [Register as a developer]({% link marketplace/sellers/developer-register.md %})
11+
- [Marketplace developer portal]({% link marketplace/sellers/developer-portal.md %})

src/marketplace/sellers/analytics.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
group: marketplace-sellers
3+
title: Analytics
4+
---
5+
6+
You can view data about the performance of your extension in the marketplace.
7+
8+
## View your performance data
9+
10+
In the top navigation of the Marketplace Developer portal, go to **Reports** > **Analytics**.
11+
12+
![]({% link marketplace/sellers/images/reports-analytics.png %}){: .zoom}
13+
_Marketplace Traffic Performance Metrics_
14+
15+
## Traffic overview
16+
17+
|Field|Description|
18+
|------|-----------|
19+
|Global|Shows page hits for top-level categories for the last 7 days. Click an item on the table key to remove it from the graph or to add it back.|
20+
|My Products|Shows page hits for your top five products. All products and their page hits are listed in the table below the graph. Click an item on the table key to remove it from the graph or to add it back.|
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
group: marketplace-sellers
3+
title: Before You Begin
4+
---
5+
6+
Before you begin the extension submission process, you need to have the following items ready:
7+
8+
## Technical items
9+
10+
- The [extension code package]({% link marketplace/sellers/technical-review-guidelines.md %})
11+
- A [user guide, reference manual, or installation guide]({% link marketplace/sellers/content.md %})/a> (at least one is required)
12+
- [Release notes]({% link marketplace/sellers/submit-for-technical-review.md %})
13+
- [License information]({% link marketplace/sellers/submit-for-technical-review.md %}) (license type or custom license name and link)
14+
- [Magento version compatibility]({% link marketplace/sellers/extension-version.md %})
15+
- [Extension version number]({% link marketplace/sellers/extension-version.md %})
16+
17+
## Marketing items
18+
19+
- A [product icon]({% link marketplace/sellers/submit-for-marketing-review.md %})
20+
- A [short description]({% link marketplace/sellers/content.md %}) of your extension
21+
- A [detailed description]({% link marketplace/sellers/content.md %}) of your extension
22+
- [Video links]({% link marketplace/sellers/submit-for-marketing-review.md %})
23+
- [Magento version compatibility]({% link marketplace/sellers/submit-for-marketing-review.md %}) information
24+
- [Pricing information]({% link marketplace/sellers/submit-for-marketing-review.md %}) for your extension

src/marketplace/sellers/branding.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
group: marketplace-sellers
3+
title: Branding
4+
---
5+
6+
The Magento name and its related logos are trademarks owned by Magento, Inc. Your extension and listing must not violate the trademarks and copyrights of Adobe, Inc., or those of any other party. To learn more, see [Magento License / Trademark][1].
7+
8+
## Magento name
9+
10+
Magento <sup>®</sup> is a registered trademark, and must include the registration symbol the first time the name appears in your personal profile, company profile, product profile, or standalone document. After the first occurrence in a document, the Magento name can be used without the registration symbol. To insert the registration symbol into HTML, place the cursor immediately after the Magento name, and enter either the numeric code for symbol name.
11+
12+
- `&amp;#174;` - Registration symbol numeric value
13+
- `&amp;reg;` - Registration symbol name
14+
15+
Your use of the Magento name cannot suggest an affiliation with Magento. The Magento name can be referenced only as follows:
16+
17+
- Correct - “I create extensions for Magento.”
18+
- Incorrect - “I create Magento extensions.” or “My Magento Extension...”
19+
20+
When referencing yourself or your company, use the _specializing in Magento_ phrasing.
21+
22+
- Correct - “We are a development agency specializing in Magento.”
23+
- Incorrect - “We are a Magento development agency.”
24+
25+
The Magento name **cannot** be used in any of the following:
26+
27+
- Name or title of the extension
28+
- Extension icon
29+
- Developer branding
30+
- Your domain name
31+
- Your username or screen name
32+
- Your email address or email domain
33+
34+
## Magento logo
35+
36+
Approved Magento trademarks can be used in your extension listing or website only to refer to related Magento products or services.
37+
38+
- The logo must be the current logo that is provided by Magento.
39+
- The Magento logo must not be altered in any way.
40+
- The Magento logo must be half the size of your own branding, to avoid the suggestion of any affiliation.
41+
42+
[1]: https://magento.com/legal/licensing
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
group: marketplace-sellers
3+
title: Business Value
4+
---
5+
6+
Extensions with a clearly stated business value are easy for us to promote, and easy for customers to find.
7+
8+
## Utility
9+
10+
- All extensions should address a business need by solving an issue or enhancing existing functionality.
11+
- Any extension that does not serve a useful purpose will be rejected.
12+
13+
## Relevancy
14+
15+
- Create an extension that addresses a specific business case or solves a common problem faced by Magento merchants.
16+
- Take a survey to see what extensions are already available on Magento Marketplace.
17+
- Differentiate your extension from other solutions. Be innovative, and do not copy ideas from other developers.
18+
19+
## Pricing
20+
21+
- Items listed on Magento Marketplace can be offered for free, or sold as commercial products.
22+
- Items offered for sale on Magento Marketplace must reflect fair market value, and have a minimum price of $25. If the extension is also available for sale on your site, the prices must be the same.
23+
- All purchases are paid for in US currency.
24+
- Items sold on Magento Marketplace are subject to a revenue sharing fee that is paid by the developer.
25+
26+
## Appeal
27+
28+
- Create an extension that has broad appeal.
29+
- Your extension might be rejected if it appeals to only a small number of merchants.
30+
31+
## Promotion
32+
33+
- We will do our best to put your extension in front of merchants, but we need your help!
34+
- Be your own cheerleader.
35+
- Create case studies that show the traction you have with merchants, and tell success stories of merchants who use your extension.
36+
- Establish yourself as a strong partner. Work closely with the Marketplace team to help us highlight your work.
37+
- If there is an apparent lack of interest in your extension, we will review any issues with you. If after a period of time the level of interest does not improve, the extension might be removed from Magento Marketplace.

0 commit comments

Comments
 (0)