[Intum Pomoc](https://intum.pl/pomoc.md) / [Pliki](https://intum.pl/pomoc/cms/pliki.md)

# [Pliki](https://intum.pl/pomoc/cms/wgrywanie-plikow-cms.md)

Pliki (w kodzie i w JSON-owym API nazywane „assetami") to zasoby, których nie edytujesz jako
tekstu na stronie - obrazy, arkusze CSS i skrypty JavaScript. Każdy wgrany plik trafia na szybki
serwer plików i dostaje stały adres, który wklejasz w szablonie, stronie albo artykule.

> [!PATH]
> [CMS → Pliki](app:/cms/assets) → **Nowy plik**

## Wgrywanie pliku {#wgrywanie-pliku}

Wybierz plik i zapisz - **Rodzaj** i **Nazwa** ustawiają się same z nazwy i rozszerzenia pliku;
poprawisz je w **Pokaż opcje dodatkowe**, jeśli trzeba. Obsługiwane rodzaje to obraz (JPG, PNG,
GIF, SVG), CSS, JavaScript i archiwum ZIP.

Nazwa musi być unikalna na koncie - dwóch plików o tej samej nazwie nie da się zapisać, nawet
w różnych folderach.

> [!WARNING]
> Zmiana **Nazwy** pliku zmienia też jego adres publiczny. Jeśli adres pliku jest już gdzieś
> wklejony (w szablonie, treści strony, poza Intumem), po zmianie nazwy przestanie tam działać -
> trzeba go tam podmienić ręcznie.

## Foldery {#foldery}

Pliki porządkujesz w foldery - przycisk **Nowy folder** przy liście. Foldery mogą być zagnieżdżone
(np. `obrazy/ikony`), a nazwa folderu musi być unikalna w obrębie folderu nadrzędnego. Po lewej
stronie listy plików jest skrót do folderów oraz do samych obrazów, plików CSS i JS.

## Import archiwum ZIP {#import-zip}

Wgranie pliku ZIP samo rozpakowuje jego zawartość - każdy plik w środku staje się osobnym plikiem
w Plikach, a foldery z archiwum odtwarzają się jako foldery. Ukryte pliki systemowe macOS
(`__MACOSX`, pliki zaczynające się od `.`) są pomijane.

## Adres pliku {#adres-pliku}

Po zapisaniu pliku pod jego szczegółami (i w kolumnie na liście) pojawia się stały adres z
przyciskiem do skopiowania - to on trafia do `src` obrazka, `href` arkusza CSS albo `src` skryptu.
Plik jest publiczny, więc adres działa też poza Intumem, bez logowania.

## Gdy coś nie działa {#gdy-cos-nie-dziala}

**Wgrywam archiwum ZIP z plikami `.html` w środku, a te pliki nie pojawiają się na liście.**
Import ZIP-a poprawnie tworzy pliki obrazów, CSS, JS i SVG z archiwum, ale pliki `.html` w
środku archiwum obecnie nie zapisują się - reszta plików z tego samego archiwum importuje się
normalnie. Zgłoś to do wsparcia, jeśli takie pliki są Ci potrzebne. Więcej przyczyn, dla
których plik się nie pokazuje (także stara wersja z pamięci podręcznej przeglądarki po
podmianie pod tą samą nazwą):
[Obrazek albo plik się nie ładuje](cms/cms-problem-plik-sie-nie-laduje).