frontend-app-publisher

KO | EN

gitlite — search

#python #react #ai #typescript #machine-learning #rust #linux #docker #macos #kubernetes #vue #awesome-list #pytorch #ios

frontend-app-publisher

(★ 22)

Publisher frontend to manage course creation and marketing content curation.

frontend-app-publisher Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

🛑🛑🛑 This repo is no longer maintained. If you need to use it, please fork your own version that you maintain. 🛑🛑🛑

# frontend-app-publisher

Publisher integrates with the course discovery, ecommerce, and Studio services and can be used to
create new courses and course runs which will be pushed out to Studio for content authoring. Inside
of Publisher, the course team can manage ecommerce products, marketing information, and creation of
new course runs within a course.

# When to use Publisher

When deciding whether to use Publisher, consider the following:

## Does Publisher replace Studio?

In short, no.  Publisher is not a course authoring tool, and doesn't replace Studio for the editing
of course content.

However, it does replicate Studio functionality insofar as it relates to creating and editing course
metadata.  Put simply, if your organization opts to use Publisher, course authors will no longer use
Studio when creating courses, configuring their settings, writing about pages, and instantiating
course runs.  They'll do so via Publisher, but will still go to Studio to flesh out course content.

## If Publisher doesn't replace Studio, what is it good for?

Publisher was primarily created to make it possible for courses to undergo a draft, review, and
publish cycle, in a workflow that resembles Github reviews:

1. A course author creates a course or a course run, then submits it for review.

1. Review staff is automatically notified, after which they comment and/or suggest changes to the
   course in a manner that is easily digestible by the author.  Think colored diffs.

1. Once review is done, the author is automatically notified, and can proceed to accept, reject, or
   modify the suggested changes.

1. After the review process is finalized, the course can be published automatically.

This is not all, though.  In implementing the above, Publisher also:

* Streamlines the management of course runs.  Where in Studio it was previously difficult to view a
    course's runs at a glance, in Publisher this information is available more directly and
    concisely.

* Standardizes the process of creating About pages and their formatting.

* Facilitates integration of courses with other Open edX components such as Discovery, Programs, and
    eCommerce: there's no longer a need to manage course runs separately in each one.  For instance,
    when creating a course in Publisher, the author is required to enter a price for the
    certificate, and this information is subsequently published in eCommerce with no need to do so
    manually.

## This sounds nice, but do I really need it?

Publisher is most useful for organizations that:

* Require an Open edX-integrated tool that facilitates the review and publication process for a
    large number of courses.

* Need to review and publish course content produced by third parties.

* Host a significant number of courses and/or create course runs frequently, and are interested in a
    more efficient way of managing them.

* Are heavy users of eCommerce or Programs, and would like a centralized way to manage integration
    of courses.

If your organization doesn't fall into one of the above categories, Publisher can still be useful
but will likely not be considered mission-critical.  For a detailed feature-by-feature guide, refer
to the [Introduction to Publisher (edx.org-specific resource)](https://edx.readthedocs.io/projects/edx-partner-course-staff/en/latest/set_up_course/pub_create_ann_course/pub_introduction.html)
chapter of the courseware development documentation.

# Important Note

At this point in time, there is no standard process for installing Microfrontends in a production
setting, but Publisher is still being provided so the community can become more familiar with it and
possibly configure and install it on their own.

# Development Environment

## Getting Started

This application requires an edx-platform instance for authentication. For local development
you should use [Tutor](https://docs.tutor.edly.io/), the community-supported Open edX development environment.

See the [instructions on using the Tutor MFE plugin here](https://github.com/overhangio/tutor-mfe?tab=readme-ov-file#mfe-development).

The edX Docker Devstack is now deprecated.
    * https://github.com/openedx-unsupported/devstack

You should be able to view it in a web browser at `localhost:18400`.

## Installation

1. Clone your new repo:

``git clone https://github.com/openedx/frontend-app-publisher.git``

2. Use the version of Node specified in ``.nvmrc``

Using other major versions of node *may* work, but this is unsupported.  For
    convenience, this repository includes an .nvmrc file to help in setting the
    correct node version via `nvm <https://github.com/nvm-sh/nvm>`_.

3. Install npm dependencies:

``cd frontend-app-publisher && npm ci``

4. Start the dev server:

``npm start``

## Running Tests

Note: The assumption behind running any of these commands is that the user is
already shelled into the container using the `make frontend-app-publisher-shell`
command in devstack.

Currently we are using Jest and @testing-library/react for our testing

1. The following command will run the tests using npm. Output will show up in your terminal.

```
    make test
    ```

Other useful commands exist in the `package.json` file.

* `npm run snapshot` - will update the snapshots for snapshot tests

2. To run tests on a specific folder or file, use Jest directly.

```
    ./node_modules/.bin/jest path/to/folder/
    ```
    or
    ```
    ./node_modules/.bin/jest path/to/file.test.js[x]
    ```

Additionally, for snapshot tests, you can update only the snapshots in a folder or for a test by appending `-u` to the end of the command.

## Linting

To lint your javascript and sass run:

```
    make lint
    ```
  License
 =======

The code in this repository is licensed under the AGPLv3 unless otherwise
noted.

Please see `LICENSE <LICENSE>`_ for details.

Contributing
============

Contributions are very welcome.  Please read [How To Contribute](https://docs.openedx.org/en/latest/developers/references/developer_guide/process/index.html) for details.

This project is currently accepting all types of contributions, bug fixes,
security fixes, maintenance work, or new features.  However, please make sure
to have a discussion about your new feature idea with the maintainers prior to
beginning development to maximize the chances of your change being accepted.
You can start a conversation by creating a new issue on this repo summarizing
your idea.

Getting Help
===========

If you're having trouble, we have discussion forums at
https://discuss.openedx.org where you can connect with others in the community.

Our real-time conversations are on Slack. You can request a [Slack
invitation](https://openedx.org/slack), then join our
[community Slack workspace](https://openedx.slack.com/)  Because this is a
frontend repository, the best place to discuss it would be in the
[#wg-frontend channel](https://openedx.slack.com/archives/C04BM6YC7A6).

For anything non-trivial, the best path is to open an issue in this repository
with as many details about the issue you are facing as you can provide.

https://github.com/openedx/frontend-app-publisher/issues

For more information about these options, see the [Getting Help](https://openedx.org/community/connect) page.

The Open edX Code of Conduct
============================

All community members are expected to follow the [Open edX Code of Conduct](https://openedx.org/code-of-conduct/).

Reporting Security Issues
=========================

Please do not report security issues in public. Please email security@openedx.org.

frontend-app-publisher

frontend-app-publisher Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

frontend-app-publisher

frontend-app-publisher Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README