View source for EVE-EMU/Extensions

{{#eveaccess:public}}

= EVE-EMU Wiki Extensions =

This wiki runs custom extensions built for the EVE-EMU stack. Parser functions render EVE assets from [https://images.evetech.net images.evetech.net]. SSO uses [https://auth.eve-emu.com/dashboard/ Alliance Auth OIDC].

== EveSDE parser functions ==

All functions are case-sensitive. Use the <code><nowiki>{{#name:...}}</nowiki></code> form.

{| class="wikitable"
! Function !! Syntax !! Description
|-
| Type icon || <code><nowiki>{{#eveicon:</nowiki>''typeID''<nowiki>|</nowiki>''size''<nowiki>}}</nowiki></code> || Renders a type icon (default size 64)
|-
| Type render || <code><nowiki>{{#everender:</nowiki>''typeID''<nowiki>|</nowiki>''size''<nowiki>}}</nowiki></code> || Renders a type portrait (default 256)
|-
| Corp logo || <code><nowiki>{{#evecorp:</nowiki>''corpID''<nowiki>|</nowiki>''size''<nowiki>}}</nowiki></code> || Corporation logo
|-
| Alliance logo || <code><nowiki>{{#eveally:</nowiki>''allianceID''<nowiki>|</nowiki>''size''<nowiki>}}</nowiki></code> || Alliance logo
|-
| Show Info panel || <code><nowiki>{{#eveshowinfo:</nowiki>''kind''<nowiki>|</nowiki>''id''<nowiki>|</nowiki>''name''<nowiki>|</nowiki>''Field=Value;...''<nowiki>}}</nowiki></code> || In-game style info box (<code>kind</code>: type, corp, alliance)
|-
| Page access || <code><nowiki>{{#eveaccess:</nowiki>''rule''<nowiki>}}</nowiki></code> || Restrict who can read the page (see below)
|}

=== Examples ===

'''Tritanium (type 34) icon and render:'''
<pre>
{{#eveicon:34|64}} {{#everender:34|128}}
</pre>

'''False Gods corporation logo:'''
<pre>
{{#evecorp:98799892|128}}
</pre>

'''WOMP alliance logo:'''
<pre>
{{#eveally:99010468|128}}
</pre>

'''Show Info panel for a ship:'''
<pre>
{{#eveshowinfo:type|606|Velator|Group=Frigate;Race=Minmatar}}
</pre>

Live SDE pages are under [[SDE/Home|SDE/Home]] (e.g. [[SDE/Types/Tritanium|Tritanium]]; type IDs redirect).

== Page access (public vs auth groups) ==

Add <code><nowiki>{{#eveaccess:...}}</nowiki></code> at the top of a page to control read access. Editing still requires a logged-in wiki account (via SSO).

{| class="wikitable"
! Rule !! Syntax !! Who can read
|-
| Public (default) || <code><nowiki>{{#eveaccess:public}}</nowiki></code> || Everyone
|-
| Members only || <code><nowiki>{{#eveaccess:<F4L5E>}}</nowiki></code> || Any logged-in user
|-
| Auth groups || <code><nowiki>{{#eveaccess:Group A|Group B}}</nowiki></code> || Users in at least one listed corporation or alliance Auth group (synced at login)
|}

'''Example — officers only:'''
<pre>
{{#eveaccess:Director|Executor}}

= Fleet doctrine =
...
</pre>

Group names must match alliance Auth state/group names exactly. Groups are synced from the OIDC <code>groups</code> claim when users log in.

== SSO (Alliance Auth OIDC) ==

* '''Auth dashboard:''' [https://auth.eve-emu.com/dashboard/ auth.eve-emu.com]
* '''Wiki login:''' Special:UserLogin → '''openidconnect'''
* '''Permissions:''' anonymous users can read public pages; members (<code>user</code> group) can edit and upload

If login fails, an admin should re-register the OIDC client:
<pre>
docker compose exec aa-web python /app/site/manage.py shell -c \
  "exec(open('/app/deploy/aa_docker/mediawiki_oidc_register.py').read()); register_mediawiki_oidc()"
</pre>

== EvePhoton skin ==

The wiki uses the '''EvePhoton''' skin (Tranquility dark palette) with EVE-EMU / False Gods branding. Chrome CSS lives in the EveSDE extension.

== SDE bulk import ==

Administrators import SDE data with the <code>importEveSde.php</code> maintenance script. See the project <code>docs/MEDIAWIKI.md</code> for export/import commands.

[[Category:Basic Guides]]
[[Category:wiki Maintenance]]