# You're here, at the VHS wiki

Get involved - [Edit this wiki](/wiki/vhswiki/editing)

## Things to do on the site:

- make the file structure match the new organizational structure.
  - e.g. <del>currently there are a bunch of documents in `/wiki/tools/laser_cutter/`, those should be moved to `/wiki/groups/lasercutter/`,</del> links adjusted, and a redirect set up.
  - a million other examples of this
- get rid of the compendium of champions, it's not valid anymore - clean up links - figure out what if anything should replace that (i.e. something that explains committees?)
- delete stuff - there is lots of stuff that can be deleted.
  - [proposal](wiki:vhswiki:deletion) for a deletion process
- style the form on [contact-us](/contact-us) page.

# Tech details about this website

This website is an instance of dokuwiki. We're using the Mikio theme, unmodified, with a custom ["subtheme"](/lib/tpl/mikio/themes/vhsresponsive/style.css) (just a css file) that defines a few extra styles to tighten up things on mobile.

### Outstanding PRs/issues related to the mikio theme:

- show the toolbar when user is not admin or manager or page creator
  - [PR](https://github.com/nomadjimbob/mikio/pull/121) / [issue](https://github.com/nomadjimbob/mikio/issues/120) - MERGED
- add ability to customize title format
  - [PR](https://github.com/nomadjimbob/mikio/pull/119) / [issue](https://github.com/nomadjimbob/mikio/issues/118) - MERGED
- Accessibility scanners point out a missing alt attribute on logo image
  - [PR](https://github.com/nomadjimbob/mikio/pull/122) - MERGED

## Plugins we're using, and why:

- [Advanced DokuWiki](https://www.dokuwiki.org/plugin:advanced) - Installed to allow editing config files not otherwise available in the UI - may not be needed.
- [Bureaucracy Plugin](https://www.dokuwiki.org/plugin:bureaucracy) - enables the [contact form](/contact-us).
- [Commonmark Plugin](https://www.dokuwiki.org/plugin:commonmark) - put `<!DOCTYPE markdown>` at the top of a page to enable [markdown syntax](https://commonmark.org/help/)
- [indexmenu plugin](https://www.dokuwiki.org/plugin:indexmenu) - list the contents of a wiki namespace. see [this page](/wiki/groups/) for an example.
- [Meta plugin](https://www.dokuwiki.org/plugin:meta) - used to set the page title, when we want it to be something other than the first heading on the page. used on the [Home page](/start).
- [Mikio plugin](https://github.com/nomadjimbob/mikioplugin) - complements our theme (mikio) by adding a bunch of bootstrap ui layout things. Used on the [membership page](/membership) to make the payment options section
- [OrphansWanted plugin](https://www.dokuwiki.org/plugin:orphanswanted) - Generates the [orphans](/wiki/vhswiki/orphans) page, which lists orphan pages and wanted pages
- [Redirect Manager](https://github.com/ssahara/dw-plugin-redirect2) plugin - used to redirect old pages to new pages, e.g. [tool](/tool) to [tools](/tools)
- [Semantic Plugin](http://www.dokuwiki.org/plugin:semantic) - puts meta description and opengraph tags in the html header
  - We are currently running a modified version that makes the page image fall back to the wiki logo - hoping to get this change adopted upstream [PR](https://github.com/giterlizzi/dokuwiki-plugin-semantic/pull/26)
- [smtp plugin](https://www.dokuwiki.org/plugin:smtp) - used by the [contact](/contact-us) page
- [Video Sharing Site Plugin](https://www.dokuwiki.org/plugin:vshare) enables the youtube video on the home page.
-  [VHS Tags](https://github.com/vhs/dokuwiki-vhstags) - an in-house plugin to add some custom HTML here and there around the site. Used for google calendar embeds, google maps embeds, stripe and paypal buttons, etc.
   - Currently deployed via git checkout - go to `/var/containers/website/var/storage/lib/plugins/vhstags/` and `git pull origin main` to update.
   - Planning to deploy this via the dokuwiki plugin index when the rate of change slows down and I've had some time to generalize more of the code.

## Bugs:

* ublock origins with `EasyList – Social Widgets` turned on, the youtube widget doesn't show up - but it DOES show up on the current site
* <del>put a search bar in the submenu (blue bar) - ideally it's a magnifying glass that when clicked reveals the search bar</del>
* <del>merge VHS Stripe Buttons and VHS Tags plugins into one plugin, store it in GIT</del>
* Change the VHS plugin to be deployed via the dokuwiki plugin directory
* <del>broken embed on https://vanhack.ca/wiki/history for 360 tour</del> Deleted, as the site hosting the 360 tour has shutdown. However an image from someone that was around back then would be a good replacement
* delete all the dead pages in `/wiki/area` that have been merged into the flat single page `/wiki/area` - warning: there are a couple pages in the /wiki/area/ directory that are un-merged, like the laser materials storage page.
* <del>images larger than 1MB are being rejected, probably a webserver setting, e.g. https://www.dokuwiki.org/faq:uploadsize</del>
* <del>$75/month [stripe button](/membership) is broken</del>
* <del>delete the `kb` directory, it's functionally empty and i've removed the main link to it.</del>
* <del>sometimes a blank page is rendered. It can be fixed with `?purge=true`</del> fixed
* <del>/tool page should redirect automatically to /tools, look into redirect plugins</del> redirect plugin added
* <del>design should be a little more responsive.</del>
  - <del>It falls apart on mid-sized screens - on very small screens the hamburger menu appears, but mid-size screens it's messy - ESPECIALLY when logged in because of all the extra buttons</del>
  - <del>stuff is cropped a little on mobile</del>
* <del>Stripe buttons are online, but haven't been confirmed to work! Switch my subscription over to stripe to make sure</del> it's all good!
* <del>redirects to add to the web server for this:</del>
  - <del>`/wp/*` -> `/*`</del>
  - <del>`/doku.php?id=$1:$2` -> `/wiki/$1/$2`</del>
* <del>over on the membership page, there is an un-formatted link in the first FAQ question</del> dokuwiki doesn't allow links in headers. blanket rule.