PHPackages                             alingsas-kommun/municipio-customisation - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. alingsas-kommun/municipio-customisation

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

alingsas-kommun/municipio-customisation
=======================================

Custom styling and settings for Alingsås kommun's main Municipio setup

0.3.3(1mo ago)0149MITPHP

Since Oct 21Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/Alingsas-Kommun/alingsas-municipio-customisation)[ Packagist](https://packagist.org/packages/alingsas-kommun/municipio-customisation)[ RSS](/packages/alingsas-kommun-municipio-customisation/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (59)Used By (0)

Alingsås tillägg för Municipio-anpassning
=========================================

[](#alingsås-tillägg-för-municipio-anpassning)

Ett WordPress-tillägg som ger anpassad funktionalitet och förbättringar för Alingsås kommuns Municipio-baserade webbplats. Innehåller skräddarsydd kod för att uppnå design och innehållsstruktur som varit svår att åstadkomma med grunduppsättningen.

Teknisk struktur och implementation
-----------------------------------

[](#teknisk-struktur-och-implementation)

Tillägget är byggt på objektorienterad princip och använder huvudfilen för att läsa in och initiera de klasser som används. Composer tillsammans med packagist.org gör det hela enkelt installerbart i Municipios composer-filer.

För att utveckla och bygga tillägget används Vite. Under utvecklings används Vites utvecklingsserver för att läsa in stilmallar och skript. `dist`-mappen får då inte vara tillgänglig utan måste tas bort, annas läses filerna härifrån. För att starta utvecklingsläge använd `npm run dev`. Används istället `npm run build` för att bygga filerna för att testa produktionsläge.

TODO: Förbättring här skulle kunna vara att använda WordPress environment-variabel tillsammans med `dist`-mappen för att aktivera produktionsfiler. Om miljön är `development` strunta i att inkludera distributionsfilerna även om de finns på plats.

Strukturerat enligt följande princip:

- **`/acf`**: Definition för fältgrupper
- **`/components`**: Skräddarsydda komponenter
- **`/dist`**: Skapas när tillägget byggs och innehåller stilmallar och skript
- **`/helpers`**: Stödfunktioner som återanvänds av olika funktioner
- **`/includes`**: Merparten av tilläggets funktionalitet ligger här. Allt i denna mapp läses in vid inladdning
- **`/languages`**: Språkfiler (byggs med `npm run make-pot` och översätts med POEdit)
- **`/src`**: Källkod för stilmallar och skriptfiler. Stilmallar är uppdelade och använder Sass CSS
- **`/views`**: Anpassade vyer för sök, evenemang och nyheter

Nyckelfunktioner
----------------

[](#nyckelfunktioner)

### Allmän extrafunktionalitet

[](#allmän-extrafunktionalitet)

- **Digital anslagstavla**: Ny posttyp för att husera innehåll för digital anslagstavla
- **Webbsändningar**: Stöd för externa webbsändningar
- **Lediga jobb**: Läses in externt från Visma till skräddarsydd posttyp. Integration ligger utanför detta tillägg.
- **Anpassade komponenter**: Skräddarsydda komponenter som inte återfinns i Municipios grundinstallation
- **Skräddarsydda stilmallar och skript**: Läses in för att anpassa utseende och funktionalitet
- **Schemalagda jobb**: Skräddarsydda schemalagda jobb återfinns i `includes/Cron.php`. I dagsläget endast för att avpublicera inlägg för digitala anslagstavlan.

### Stöd för anpassat utseende

[](#stöd-för-anpassat-utseende)

Filerna `includes/AppearanceSettings.php` och `helpers/Appearance.php` utgör grunden för de anpassningar som kan göras för utseendet med avseende på särprofiler. Här användaren att skapa en grund som sedan kan appliceras på särskilda sidor och på vissa komponenter.

- **Särprofiler**: Skapa och tillämpa teman med specifika färger på olika delar av webbplatsen
- **Sökvägsbaserad tillämpning**: Använd teman automatiskt baserat på särskild sökväg
- **Sidspecifik anpassning**: Ställ in tema på specifika sidor
- **CSS-variabler**: Genererar automatiskt CSS-variabler för alla anpassade färger och teman som kan användas i temat

### Utökad sökfunktionalitet

[](#utökad-sökfunktionalitet)

Den grundläggande sökfunktionen är väldigt begränsad och presenterar sökresultat rakt upp och ned. Sökresutatsidan har anpassats och så har även de individuella sökresultaten.

Filen `includes/Search.php` innehåller merparten av koden för detta och den skräddarsydda sidan återfinns i `views/custom-search.blade.php`.

- **Anpassad sökresultatsida**

    - Flikar för innehållstyp
    - Träffantal per innehållstyp
    - Brödsmulor för individuella träffar
    - Stöd för paginering av sökträffar
- **Filtrera sökresultat efter posttyp**

    - Sidor
    - Nyheter
    - Lediga jobb
    - Evenemang
    - Driftinformation

### Evenemangsanpassning

[](#evenemangsanpassning)

Alingsås ville ha ett skräddarsytt utseende för evenemangskorten vilket möjliggjorts med en egen komponent som har ett tillhörande utseende. Utöver detta har även extra kod lagts till för att evenemangen ska presenteras i korrekt ordning i inläggsmodulen. Här hänvisas till kod från evenemangstillägget för att inte duplicera någon kod. Anpassningen sker generellt i `includes/Events.php`.

- **Anpassad visning i inläggsmodulen**: `views/events.blade.php`
- **Korrekt sortering i inläggsmodulen**: `includes/Events.php`
- **Ny komponent för visning av evenemang**: `components/Event`
- **Stödklass för att formatera data korrekt**: `helpers/Event.php`
- **Korrekt visning på arkivsidan**: `includes/controllers/AkEventTemplate.php`

### Advanced Custom Fields

[](#advanced-custom-fields)

För extrainställningar och extra fält används tillägget som är branschstandard för ändamålet - Advanced Custom Fields. Detta tillsammans med Helsingsborgs funktion för automatisk import och export och översättning av fältgrupper gör det möjligt att utöka sidor och moduler med extra inställningar. Dessa återfinns i `acf/json` och `acf/php` beroende på önskat format.

- **Fältgrupper**:
    - Sidinställningar
    - Utseendeinställningar
    - Allmänna modulinställningar
    - Inställningar för kortmodulen
    - Inställningar för innehåll på digital anslagstavla
    - Inställningar för webbsändningar

Version
-------

[](#version)

Current version: 0.2.0

Författare
----------

[](#författare)

Utvecklad av Consid () för Alingsås kommun

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance92

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 67.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~18 days

Recently: every ~32 days

Total

29

Last Release

40d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fbbb12ade79f34895ff5b846358763e02483e3010b5b4a6e0ca82bd6139ab14b?d=identicon)[considadam](/maintainers/considadam)

![](https://www.gravatar.com/avatar/e5a271e8ae3070a4b165c06514325676721410feec5a808e62ab359329ac9753?d=identicon)[viktor7ltz](/maintainers/viktor7ltz)

![](https://www.gravatar.com/avatar/c54163a5b097fefafe64830b3586e8f8d2fdb76958a142e7a32c9459167da908?d=identicon)[michaelclaesson](/maintainers/michaelclaesson)

---

Top Contributors

[![michaelclaesson](https://avatars.githubusercontent.com/u/18331514?v=4)](https://github.com/michaelclaesson "michaelclaesson (96 commits)")[![viktor7ltz](https://avatars.githubusercontent.com/u/78755786?v=4)](https://github.com/viktor7ltz "viktor7ltz (29 commits)")[![considadam](https://avatars.githubusercontent.com/u/122970703?v=4)](https://github.com/considadam "considadam (17 commits)")

### Embed Badge

![Health badge](/badges/alingsas-kommun-municipio-customisation/health.svg)

```
[![Health](https://phpackages.com/badges/alingsas-kommun-municipio-customisation/health.svg)](https://phpackages.com/packages/alingsas-kommun-municipio-customisation)
```

###  Alternatives

[braincrafted/background-process

Start processes in the background that continue running when the PHP process exists.

2976.1k1](/packages/braincrafted-background-process)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)