Skip to content

wikimedia/wikimedia-soundlogo-site

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VIP Skeleton

Welcome to VIP! This repo is a starting point for building your VIP site, including all the base folders to be built on.

Guidebooks

We recommend starting with one of the following guidebooks:

Directories

All the following directories are required and must not be removed:

  • client-mu-plugins: for always active, global plugins (similar to mu-plugins) — see our documentation for more information.
  • images: Store your site's favicons here, per this documentation. All other public-facing images should be uploaded or imported to the WordPress dashboard or stored as part of your /theme/ assets.
  • languages: For .po and .mo translation files, which specify the translated strings for the site — more details here.
  • plugins: Your site's plugins — more details here.
  • private: Provides access to files that are not directly web accessible, but can be accessed by your theme or plugin code — more details here.
  • themes: Themes to be made available to your sites – more details here. We recommend keeping the default theme available for testing purposes.
  • vip-config: For custom configuration changes and additional sunrise.php details. This folder’s vip-config.php can be used to supply things usually found in wp-config.php. More details here.

These directories will also be available on production web servers. Any additional directories created in your GitHub repository that are not included in the above list will not be mounted onto your site, and so will not be web-accessible.

For more information on how our codebase is structured, see https://docs.wpvip.com/technical-references/vip-codebase/.

The docs/ directory is a special directory that contains your documentation for your application. It is not mounted onto your site, but is available for you to use. See docs/index.php for more information.

PHPCS for checking coding standards

This repo contains a starting point for installing and using a local version of PHP_CodeSniffer (PHPCS). To get started, you'll need to have Composer installed, then open a command line at this directory, and run:

composer install

This will install PHPCS and register the below standards:

The .phpcs.xml.dist file contains a suggested configuration, but you are free to amend this. You can also extend it for more granularity of configuration for theme and custom plugins.

To run PHPCS, navigate to the directory where the relevant .phpcs.xml.dist lives, and type:

vendor/bin/phpcs

See the PHPCS documentation (or run phpcs -h) for the available command line arguments.

Support

If you need help with anything, VIP's support team is just a ticket away.

Your documentation here

Feel free to add to or replace this README.md content with content unique to your project, for example:

  • Project-specific notes; like a list of VIP environments and branches,
  • Workflow documentation; so everyone working in this repo can follow a defined process, or
  • Instructions for testing new features.

This can be detailed in the docs/ directory.