= Contents =
  - [[#Server|Server]]
    - [[#Server#Användarkonton|Användarkonton]]
  - [[#Webbsida|Webbsida]]
    - [[#Webbsida#Design|Design]]
      - [[#Webbsida#Design#Förbättringar|Förbättringar]]
    - [[#Webbsida#Karta|Karta]]
    - [[#Webbsida#Ansvariga för Stupan|Ansvariga för Stupan]]
      - [[#Webbsida#Ansvariga för Stupan#Kommentar från /etc/vastgota/ansvariga|Kommentar från /etc/vastgota/ansvariga]]
      - [[#Webbsida#Ansvariga för Stupan#Text till webbsida|Text till webbsida]]
      - [[#Webbsida#Ansvariga för Stupan#Kodlistning|Kodlistning]]
  - [[#Kalender|Kalender]]
    - [[#Kalender#Events Manager|Events Manager]]
    - [[#Kalender#Events Calendar|Events Calendar]]
    - [[#Kalender#Booking Calendar|Booking Calendar]]

= Server =
- Ubuntu 18.04 LTS.
- Wordpress genom pakethanteraren, dock med vissa ombyggningar.
- Nginx för HTTP

== Användarkonton ==
Varje person som har något att göra på (från Unix-sidan) ska ha ett
eget användarkonto. De bör även läggas till i gruppen vastgota (1004)
för att kunna komma åt rimliga filer.

{{{sh
useradd -G vastgota <user>
}}}

= Webbsida =
http://vastgota.nation.liu.se/

Västgöta Nations webbsida kör för nuvarande Wordpress. Det temat som
körs (Blogeasy) är valt för att det var det som såg minnst skit ut.

== Design ==

{{{class="right" css
/* Fullständig CSS-listning */

.main-nav-bg,
.slicknav_menu {
	background-color: #FFe500;
}
.main-navigation a,
.slicknav_nav a {
	color: #100b08;
}
.main-navigation a:hover,
.slicknav_nav a:hover {
	color: #707070;
    
}
.sub-menu .menu-item {
	background-color: #FFe500;
}
.btn {
	background-color: #FFe500;
	border-color: #100b08;
	color: #100b08;
}

.site-footer {
	background-color: #ffe500;
	color: darkgrey;
}
.site-footer a {
	color: #100b08;
}
.site-footer a:hover {
	color: #707070;
}

#content a {
	color: blue;
}

#content a::visited {
	color: purple;
}

#content .entry-meta a {
	color: #002e5b;
}

#content header a {
	color: #002e5b;
}

#content aside a {
	color: #002e5b;
}

#content footer a {
	color: #002e5b;
}

#content a.btn {
	color: #100b08;
}

.datestr, .datesep {
	font-family: monospace;
}

td.eventful {
    background-color: #FFe500;
    border-radius: 20%;
}

td.eventful-today {
	border-radius: 20%;
}
}}}

För att få temat i stil med föreningen har nedan följande CSS lagts
till. Det den framförallt gör är att byta ut alla mörkblå element mot
Västgöta-gula (`#FFe500`).

Full CSS-listning till höger.

=== Förbättringar ===

Menyalternativ med barn markeras för nuvarande inte på
skrivbordsversionen av webbsidan (dock på mobilversionen). Någonting i
stil med följande bör användas.

{{{css
.menu-item-has-children > a:after {
	content: " V";
	font-size: 80%;
	color: red;
}
}}}

`.menu-item-has-children` är den interesanta biten.

== Karta ==
På https://vastgota.nation.liu.se/attestupan/ finns en karta till
stupan. I skrivandets stund använder den
[[https://leafletjs.com/|LeafletJS]] vilket bygger på
[[https://www.openstreetmap.org/|OpenStreetMap]].


== Ansvariga för Stupan ==

Ett minde PHP-tillägg finns också (se nedan). Vilket kör genom "Code
Snippets" pluginet. Koden kan, vid behov, portas till annat format
utan större besvär. Dock är den inget vidare.

Det lägger till shortcoden `[ansvariga]`, vilket ger en
lista på ansvariga för Stupan. Informationen fås från filen
`/etc/vastgota/ansvariga`, och är på formen:
{{{
2018-10-12 Hugo
}}}
Altså ISO-8601 datum, följt av ett mellanslag och ett namn. Mellanslag
får förekomma i namnet. Rader som börjar med `#` är kommentarer, end
of line kommentarer stödjs inte.

Shortcoden tar ett argument, `back`, vilket är hur många veckor backåt
mistorik ska visas. Om inget argument ges visas full historik. På
ättestupans webbsida visas historik fyra veckor bakåt, samt så länkas
det till en sida med full historik.

=== Kommentar från /etc/vastgota/ansvariga ===
{{{sh
# The following is a list of people responsible for Ättestupan.
# Each line should contain an ISO-8601 formatted date (YYYY-MM-DD),
# followed by a space and finally any number of characters which make
# out the name.
# Entries should be placed in chronological order.
# Refrain from deleting old entries unless totally necessary.
}}}

=== Text till webbsida ===
https://vastgota.nation.liu.se/attestupan/ansvariga/

Just nu står det

    Vi behöver inget snöre

Jag tror det duger bra.

=== Kodlistning ===

{{{php
<?php
add_shortcode( 'ansvariga', function ($atts) {
  $a = shortcode_atts( array(
	"back" => 0
	), $atts);

  if ($a["back"] == 0) {
	$back = false;
  } else {
  	$back = strtotime("-". $a["back"] . " weeks");
  }

  $retstr = "";
  $retstr .= "<ul>";
  $ansvariga = array();
  $contents = file_get_contents("/etc/vastgota/ansvariga");
  $lines = explode("\n", $contents);
  foreach ($lines as $row => $data) {
    if ($data == "") continue;
	if ($data[0] == "#") continue;
    $row_data = explode(" ", $data, 2);
    $ansvariga[$row_data[0]] = $row_data[1];
  }

  $now = time();
  foreach ($ansvariga as $datestr => $person) {
    // We compare with the day after since they are responsible for the evening.
    $then = strtotime($datestr) + 3600 * 24;
	if ($back != 0 && $then < $back) continue;
    $retstr .= "<li>";
    if ($now > $then) { $retstr .= "<del>"; }
    $retstr .= "<span class='datestr'>$datestr</span> <span class='datesep'>::</span> <span class='dateper'>$person</span>";
    if ($now > $then) { $retstr .= "</del>"; }
    $retstr .= "</li>";
  }
  $retstr .= "</ul>";
  return $retstr;
} );
}}}

---------------

All kod på den här sidan är manuellt inklippt. Skillnader från det som
faktiskt körs kan finnas.

= Kalender =

https://git.hornquist.se/vg-cal

- Visas på lämpligt sätt
- VCalendar/.ics nedladdning
- Manuellt tillagda events.
- Auto-hantering av ansvariga

== Events Manager ==
http://wp-events-plugin.com/

Den vi använder.

Den helt klart bästa. Tillhandahåller upprepade events.
Saknar lite när det kommer till användarvänlighet samt display, men
det går nog att lösa på sikt.

Har även ett bokningssystem i sig, oklart huruvida man kan låta vem
som skapa ny bokning, eller om det bara är för att anmäla sig till
events som finns.

== Events Calendar ==
https://theeventscalendar.com/

Helt byggd kring events, och inte återkommande events. Har dessutom en
jobbig licensmodell.

== Booking Calendar ==
https://wpbookingcalendar.com/

Med tillägget Booking Manager

Ser bra ut, men har inte heller stöd för upprepande events. Påstår sig
ha möjlighet att importera ICS strömmar, men verkar skapa en sepparat
bokning då.