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

Marketplace Migration - Sellers #6743

Merged
merged 74 commits into from
Mar 2, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
74 commits
Select commit Hold shift + click to select a range
77f83e6
Update main-nav.yml
ccondra Feb 22, 2020
19e5d82
Create marketplace-sellers.yml
ccondra Feb 22, 2020
5f24938
Uploaded Marketplace images
ccondra Feb 22, 2020
041d09b
Marketplace content
ccondra Feb 22, 2020
5414e91
Update marketplace-sellers.yml
ccondra Feb 24, 2020
9c8687a
Content files
ccondra Feb 24, 2020
a6eb6dd
Added icon images
ccondra Feb 24, 2020
246f6bb
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Feb 24, 2020
b243366
Update account-overview.md
ccondra Feb 24, 2020
e48133e
Update before-you-begin.md
ccondra Feb 24, 2020
85553c6
Update developer-register.md
ccondra Feb 24, 2020
3d6a322
Delete extension-build.md
ccondra Feb 24, 2020
1d130b7
Update extension-complete.md
ccondra Feb 24, 2020
ab5432e
Update extension-quality-program.md
ccondra Feb 24, 2020
41b1ec3
Updated links
ccondra Feb 25, 2020
2b3d561
Update main-nav.yml
ccondra Feb 25, 2020
80e9155
Renamed Getting Started
ccondra Feb 25, 2020
1e4a3a1
Update packaging-v1x-extensions.md
ccondra Feb 25, 2020
295994b
Update seller-overview.md
ccondra Feb 25, 2020
73d74e7
Updated TOCs
ccondra Feb 25, 2020
5970464
Changed TOC entries
ccondra Feb 25, 2020
fc3f4c1
Misc edits
ccondra Feb 25, 2020
9dc47f6
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Feb 25, 2020
fc738f2
Misc edits
ccondra Feb 25, 2020
30e5084
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Feb 25, 2020
2290be1
Misc edits
ccondra Feb 25, 2020
3911850
Misc Formatting
ccondra Feb 25, 2020
98f418b
Misc edits
ccondra Feb 26, 2020
01ddacf
Misc edits
ccondra Feb 26, 2020
420c05f
Update revenue-share.md
ccondra Feb 26, 2020
d105c74
Update video-tips.md
ccondra Feb 26, 2020
5840b4e
Update test-module.md
ccondra Feb 26, 2020
9967019
Update packages.md
ccondra Feb 26, 2020
7e0ab74
Update marketplace-sellers.yml
ccondra Feb 26, 2020
d634ca3
Update marketplace-sellers.yml
ccondra Feb 26, 2020
ef2b903
Update marketplace.md
ccondra Feb 26, 2020
6e67d68
Update marketplace-sellers.yml
ccondra Feb 26, 2020
046957a
Create reports.md
ccondra Feb 26, 2020
7143ad7
Renamed getting-started.md
ccondra Feb 26, 2020
3325c31
Updated navigation
ccondra Feb 26, 2020
71221f5
Create grid.html
ccondra Feb 26, 2020
a42de9f
Landing pages with tiles
ccondra Feb 26, 2020
3818fcc
Icon images
ccondra Feb 27, 2020
cd0e9cb
Update getting-started.md
ccondra Feb 27, 2020
c6a0cd1
Update seller-overview.md
ccondra Feb 27, 2020
49f2336
Update extensions.md
ccondra Feb 27, 2020
5072348
Update purchase.png
ccondra Feb 27, 2020
fd9e8b0
Update extension-complete.md
ccondra Feb 27, 2020
7393619
Removed marketplace tools
ccondra Feb 27, 2020
9f57c44
Update tech-review-content.png
ccondra Feb 27, 2020
f608c59
Moved workflow diagrams
ccondra Feb 27, 2020
c5ff93c
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Feb 27, 2020
6546fac
Update marketplace-sellers.yml
ccondra Feb 27, 2020
c6ca926
Update marketplace-sellers.yml
ccondra Feb 27, 2020
9fce1f2
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Feb 28, 2020
8cace3f
Moved content
ccondra Feb 28, 2020
2d84a3f
Update marketplace-sellers.yml
ccondra Feb 28, 2020
d9b24c6
Create profile-information.md
ccondra Feb 28, 2020
46c86e6
Delete profile-account.md
ccondra Feb 28, 2020
043e476
Create extension-create.md
ccondra Feb 28, 2020
c6aa00d
Delete extension-complete.md
ccondra Feb 28, 2020
1b00563
Updated links
ccondra Feb 28, 2020
69e72d2
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Feb 28, 2020
ca4d072
Update marketplace-sellers.yml
ccondra Feb 28, 2020
5668235
Fixed redirect syntax
ccondra Feb 28, 2020
b12248f
Update submit-for-review.md
ccondra Feb 28, 2020
a60bdc9
Renamed file
ccondra Feb 28, 2020
5fd1169
Updated link text
ccondra Feb 28, 2020
59b5d71
Update seller-overview.md
ccondra Feb 28, 2020
e52b6dd
Update review-report.md
ccondra Feb 28, 2020
2399969
Update marketplace-sellers.yml
ccondra Feb 28, 2020
48d5676
Corrected redirect
ccondra Mar 2, 2020
4198926
Added FAQ content
ccondra Mar 2, 2020
ba95cfb
Merge branch 'master' into DOC-82-marketplace-sellers
ccondra Mar 2, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/_data/main-nav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -218,6 +218,10 @@
url: /compliance/industry-compliance.html
versionless: true

- label: Extensions Marketplace
url: /marketplace/sellers/getting-started.html
versionless: true

- label: Inventory Management
url: /inventory/index.html
exclude_versions: ['2.0', '2.1', '2.2']
Expand Down
164 changes: 164 additions & 0 deletions src/_data/toc/marketplace-sellers.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,164 @@
label: Marketplace Sellers
versionless: true
pages:
- label: Getting Started
url: /marketplace/sellers/getting-started.html
versionless: true
children:

- label: Before You Begin
url: /marketplace/sellers/before-you-begin.html
versionless: true

- label: Extension Quality Program
url: /marketplace/sellers/extension-quality-program.html
versionless: true

- label: Seller Overview
url: /marketplace/sellers/seller-overview.html
versionless: true
children:

- label: Your Seller Account
url: /marketplace/sellers/account-setup.html
versionless: true

- label: Account Setup Process
url: /marketplace/sellers/account-setup-process.html
versionless: true

- label: Register as a Developer
url: /marketplace/sellers/developer-register.html
versionless: true

- label: Marketplace Developer Portal
url: /marketplace/sellers/developer-portal.html
versionless: true
children:

- label: Profile Information
url: /marketplace/sellers/profile-information.html
versionless: true

- label: Company Profile
url: /marketplace/sellers/profile-company.html
versionless: true

- label: Personal Profile
url: /marketplace/sellers/profile-personal.html
versionless: true

- label: Extensions
url: /marketplace/sellers/extensions.html
versionless: true
children:

- label: Create an Extension
url: /marketplace/sellers/extension-create.html
versionless: true

- label: Specify the Version
url: /marketplace/sellers/extension-version.html
versionless: true

- label: Complete the Extension Information
url: /marketplace/sellers/extension-information.html
versionless: true
children:

- label: Add Extension Content
url: /marketplace/sellers/content.html
versionless: true

- label: Establish Your Brand
url: /marketplace/sellers/branding.html
versionless: true

- label: Define the Business Value
url: /marketplace/sellers/business-value.html
versionless: true

- label: Update Extension Information
url: /marketplace/sellers/extension-update-information.html
versionless: true

- label: Themes
url: /marketplace/sellers/themes.html
versionless: true

- label: Shared Packages
url: /marketplace/sellers/shared-packages.html
versionless: true

- label: Review Process
url: /marketplace/sellers/submit-for-review.html
versionless: true

- label: Submit for Technical Review
url: /marketplace/sellers/submit-for-technical-review.html
versionless: true
children:

- label: Technical Review Guidelines
url: /marketplace/sellers/technical-review-guidelines.html
versionless: true

- label: Code Validation
url: /marketplace/sellers/code-validation.html
versionless: true

- label: Submit for Marketing Review
url: /marketplace/sellers/submit-for-marketing-review.html
versionless: true
children:

- label: Marketing Review Guidelines
url: /marketplace/sellers/marketing-review-guidelines.html
versionless: true

- label: Product Descriptions
url: /marketplace/sellers/product-descriptions.html
versionless: true

- label: Video Tips
url: /marketplace/sellers/video-tips.html
versionless: true

- label: Image Tips
url: /marketplace/sellers/image-tips.html
versionless: true

- label: Preview Your Submission
url: /marketplace/sellers/marketing-submission-preview.html
versionless: true

- label: View the Results
url: /marketplace/sellers/review-report.html
versionless: true
children:

- label: Resubmit an Extension
url: /marketplace/sellers/extension-resubmit.html
versionless: true

- label: Manage Sales
url: /marketplace/sellers/sales.html
versionless: true
children:

- label: Revenue Share
url: /marketplace/sellers/revenue-share.html
versionless: true

- label: Analytics
url: /marketplace/sellers/analytics.html
versionless: true

- label: Technical Reference
url: /marketplace/sellers/technical-reference.html
versionless: true
children:

- label: Packaging v1.x Extensions
url: /marketplace/sellers/packaging-v1x-extensions.html
versionless: true
10 changes: 10 additions & 0 deletions src/_includes/grid.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
<div class="columns {% if include.large %}large-{{include.large}}{% endif %}">
{% for section in include.sections %}
<div class="column">
<a href="{{ site.baseurl }}{{ section.url }}" class="card">
<h3 class="no_toc">{{ section.title }}</h3>
<p>{{ section.content }}</p>
</a>
</div>
{% endfor %}
</div>
2 changes: 1 addition & 1 deletion src/guides/v2.3/comp-mgr/marketplace/marketplace.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ functional_areas:
- Upgrade
---

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).
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).

### Log in to Magento Marketplace

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ Where:
[2]: https://packagist.org/
[3]: https://getcomposer.org/doc/05-repositories.md#path
[4]: https://www.iso.org/iso-639-language-codes.html
[5]: https://docs.magento.com/marketplace/user_guide/sellers/company-profile.html
[5]: https://docs.magento.com/marketplace/sellers/company-profile.html
[6]: https://marketplace.magento.com/
[7]: https://marketplace.magento.com
[8]: {{ page.baseurl }}/extension-dev-guide/package/package_module.html#package-metapackage
Expand Down
3 changes: 1 addition & 2 deletions src/guides/v2.3/extension-dev-guide/validate/test-module.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ See these resources for testing in [PHP](https://glossary.magento.com/php) and v

* The [Magento Coding Standard] provides a set of rules and sniffs for the [PHP_CodeSniffer] tool
* [Technical Deep Dive: How to Pass the Magento Marketplace Extension Quality Program] (video) from Magento Imagine 2017
* [Extension Quality Program] in the Magento Marketplace User Guide
* [Extension Quality Program]({% link marketplace/sellers/extension-quality-program.md %}) in the Magento User Guide
* [01 The Module Skeleton Kata] (video) by [Mage2Katas]

[Magento Testing Overview]: {{ page.baseurl }}/test/testing.html
Expand All @@ -63,6 +63,5 @@ See these resources for testing in [PHP](https://glossary.magento.com/php) and v
[Magento Coding Standard]: https://github.com/magento/magento-coding-standard
[PHP_CodeSniffer]: https://github.com/squizlabs/PHP_CodeSniffer
[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
[Extension Quality Program]: https://docs.magento.com/marketplace/user_guide/sellers/extension-quality-program.html
[01 The Module Skeleton Kata]: https://www.youtube.com/watch?v=JvBWJ6Lm9MU)
[Mage2Katas]: http://mage2katas.com/
2 changes: 1 addition & 1 deletion src/marketplace/eqp/v1/packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Packages
---

Use this resource to initiate and manage all aspects of submitting a package to the
[Magento Extension Quality Program (EQP)](http://docs.magento.com/marketplace/user_guide/extensions/extension-quality-program.html).
[Magento Extension Quality Program (EQP)]({% link marketplace/sellers/extension-quality-program.md %}).
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.

* **Technical information** - References to code artifacts, such as Magento 1 TGZ files or Composer-compliant Magento 2 ZIP files, version compatibility, and release notes.
Expand Down
21 changes: 21 additions & 0 deletions src/marketplace/sellers/account-setup-process.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
group: marketplace-sellers
title: Account Setup Process
redirect_from: /marketplace/sellers/set-up-your-account.html
---

## Step 1: Log in or register for a developer account.

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.

## Step 2: Agree to the terms of service.

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.

## Step 3: Complete your personal profile.

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.

## Step 4: Complete your company profile.

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.
11 changes: 11 additions & 0 deletions src/marketplace/sellers/account-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
group: marketplace-sellers
title: Set Up Your Developer Account
redirect_from: /marketplace/sellers/account-setup-overview.html
---

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.

- [Process overview]({% link marketplace/sellers/account-setup-process.md %})
- [Register as a developer]({% link marketplace/sellers/developer-register.md %})
- [Marketplace developer portal]({% link marketplace/sellers/developer-portal.md %})
20 changes: 20 additions & 0 deletions src/marketplace/sellers/analytics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
group: marketplace-sellers
title: Analytics
---

You can view data about the performance of your extension in the marketplace.

## View your performance data

In the top navigation of the Marketplace Developer portal, go to **Reports** > **Analytics**.

![]({% link marketplace/sellers/images/reports-analytics.png %}){: .zoom}
_Marketplace Traffic Performance Metrics_

## Traffic overview

|Field|Description|
|------|-----------|
|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.|
|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.|
24 changes: 24 additions & 0 deletions src/marketplace/sellers/before-you-begin.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
group: marketplace-sellers
title: Before You Begin
---

Before you begin the extension submission process, you need to have the following items ready:

## Technical items

- The [extension code package]({% link marketplace/sellers/technical-review-guidelines.md %})
- A [user guide, reference manual, or installation guide]({% link marketplace/sellers/content.md %})/a> (at least one is required)
- [Release notes]({% link marketplace/sellers/submit-for-technical-review.md %})
- [License information]({% link marketplace/sellers/submit-for-technical-review.md %}) (license type or custom license name and link)
- [Magento version compatibility]({% link marketplace/sellers/extension-version.md %})
- [Extension version number]({% link marketplace/sellers/extension-version.md %})

## Marketing items

- A [product icon]({% link marketplace/sellers/submit-for-marketing-review.md %})
- A [short description]({% link marketplace/sellers/content.md %}) of your extension
- A [detailed description]({% link marketplace/sellers/content.md %}) of your extension
- [Video links]({% link marketplace/sellers/submit-for-marketing-review.md %})
- [Magento version compatibility]({% link marketplace/sellers/submit-for-marketing-review.md %}) information
- [Pricing information]({% link marketplace/sellers/submit-for-marketing-review.md %}) for your extension
42 changes: 42 additions & 0 deletions src/marketplace/sellers/branding.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
group: marketplace-sellers
title: Branding
---

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].

## Magento name

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.

- `&amp;#174;` - Registration symbol numeric value
- `&amp;reg;` - Registration symbol name

Your use of the Magento name cannot suggest an affiliation with Magento. The Magento name can be referenced only as follows:

- Correct - “I create extensions for Magento.”
- Incorrect - “I create Magento extensions.” or “My Magento Extension...”

When referencing yourself or your company, use the _specializing in Magento_ phrasing.

- Correct - “We are a development agency specializing in Magento.”
- Incorrect - “We are a Magento development agency.”

The Magento name **cannot** be used in any of the following:

- Name or title of the extension
- Extension icon
- Developer branding
- Your domain name
- Your username or screen name
- Your email address or email domain

## Magento logo

Approved Magento trademarks can be used in your extension listing or website only to refer to related Magento products or services.

- The logo must be the current logo that is provided by Magento.
- The Magento logo must not be altered in any way.
- The Magento logo must be half the size of your own branding, to avoid the suggestion of any affiliation.

[1]: https://magento.com/legal/licensing
37 changes: 37 additions & 0 deletions src/marketplace/sellers/business-value.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
group: marketplace-sellers
title: Business Value
---

Extensions with a clearly stated business value are easy for us to promote, and easy for customers to find.

## Utility

- All extensions should address a business need by solving an issue or enhancing existing functionality.
- Any extension that does not serve a useful purpose will be rejected.

## Relevancy

- Create an extension that addresses a specific business case or solves a common problem faced by Magento merchants.
- Take a survey to see what extensions are already available on Magento Marketplace.
- Differentiate your extension from other solutions. Be innovative, and do not copy ideas from other developers.

## Pricing

- Items listed on Magento Marketplace can be offered for free, or sold as commercial products.
- 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.
- All purchases are paid for in US currency.
- Items sold on Magento Marketplace are subject to a revenue sharing fee that is paid by the developer.

## Appeal

- Create an extension that has broad appeal.
- Your extension might be rejected if it appeals to only a small number of merchants.

## Promotion

- We will do our best to put your extension in front of merchants, but we need your help!
- Be your own cheerleader.
- Create case studies that show the traction you have with merchants, and tell success stories of merchants who use your extension.
- Establish yourself as a strong partner. Work closely with the Marketplace team to help us highlight your work.
- 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.
Loading