Download the PHP package oojs/oojs-ui without Composer

On this page you can find all versions of the php package oojs/oojs-ui. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package oojs-ui

OOUI

OOUI is a component-based JavaScript UI library. Key features:

It is the standard library for Web products at the Wikimedia Foundation, having been originally created for use by VisualEditor.

Quick start

The library is available on npm. To install:

Once installed, include the following scripts and styles to get started:

Loading the library

While the distribution directory is chock-full of files, you will normally load only the following three:

You can load additional icon packs from files named oojs-ui-wikimediaui-icons-*.css or oojs-ui-apex-icons-*.css.

The remaining files make it possible to load only parts of the whole library.

Furthermore, every CSS file has a right-to-left (RTL) version available, to be used on pages using right-to-left languages if your environment doesn't automatically flip them as needed.

Issue tracker

Found a bug or missing feature? Please report it in our issue tracker Phabricator!

Contributing

We are always delighted when people contribute patches. To setup your development environment:

  1. Clone the repo: $ git clone https://gerrit.wikimedia.org/r/oojs/ui oojs-ui

  2. Move into the library directory:
    $ cd oojs-ui

  3. Install composer and make sure running composer will execute it (e.g. add it to $PATH in POSIX environments).

  4. Install dev dependencies:
    $ npm install

  5. Build the library (you can alternatively use grunt quick-build if you don't need to rebuild the PNGs):
    $ grunt build

  6. You can see a suite of demos in /demos by executing:
    $ npm run-script demos

  7. You can also copy the distribution files from the dist directory into your project.

  8. You can start a local web server by running php -S localhost:80 in your root dir.

  9. You can navigate to http://localhost/tests/ to run the tests locally in your browser.

We use Gerrit for code review, and Phabricator to track issues. To contribute patches or join discussions all you need is a developer account.

A new version of the library is released most weeks on Tuesdays.

Community

Get updates, ask questions and join the discussion with maintainers and contributors:

Versioning

We use the Semantic Versioning guidelines.

Releases will be numbered in the following format:

<major>.<minor>.<patch>

Release

Prerequisites

Prepare and submit the release commit

From the root of this repository, update master and check out a new release branch:

Clean-install npm dependencies, update Composer dependencies, and ensure tests pass:

Generate a list of commits that are part of this release:

In History.md, add a new heading for this version and date. Copy the list of commits into the new section and sort into five sub-sections, in order, omitting any sub-section that has no commits:

Generate the list of Phabricator tasks for this release. Copy the resulting list and save it for later. In a later step, you will add it to the commit message of the MediaWiki core commit.

Update the version number (in the following command, change 'patch' to 'minor' if you've made breaking changes):

Commit the release and submit to Gerrit. Note that if there is a Phabricator task associated with the release, you should edit the commit to add the bug number before running git review.

Publish the tag and push to NPM

After the tag commit is merged in this repo, push the tag and publish to NPM:

Update the mediawiki/vendor repo

In your local mediawiki/vendor repo, point composer to the new version and pull in the updated vendor files:

Then commit the changes with the following commit message, replacing 1.2.34 with the new OOUI version number (example: https://gerrit.wikimedia.org/r/c/mediawiki/vendor/+/813629).

Commit message format:

Push this to gerrit. Take note of the Change-Id in the commit message. Copy it and save it for later. You will need it for the Depends-On: line in the commit message when updating MediaWiki.

Update the MediaWiki core repo

In your local MediaWiki core repo, open composer.json and update the version number of oojs/oojs-ui to the new version number.

Open RELEASE-NOTES-1.NN. If there is already a list item about OOUI, update the latest version number. For example, if there is a list item that says "Updated OOUI from v1.2.0 to v1.2.33", update the latter version number fo v1.2.34. If there isn't a list item about OOUI yet, add one in the Changed external libraries section.

Open resources/lib/foreign-resources.yaml. For the OOUI listing, change the version, the purl, and the src URL to use the new version number. Compute the new integrity hash:

Then update the OOUI library files:

Then run the following command to update foreign-resources.cdx.json:

Then commit the changes with the following commit message, replacing 1.2.34 with the new OOUI version number:

Commit message format, where the list of bugs is the list you generated during the OOUI tag step, and Depends-On is set to the Change-Id of the mediawiki/vendor commit:

Then push that commit to gerrit:

Update the VisualEditor/VisualEditor repo

In your local VisualEditor/VisualEditor repo, run the script to create a commit updating the local copy of OOUI, and push the commit to Gerrit:


All versions of oojs-ui with dependencies

PHP Build Version
Package Version
Requires php Version >=7.4.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package oojs/oojs-ui contains the following files

Loading the files please wait ....