diff --git a/.env b/.env index 814cc1d91..46a8548f2 100644 --- a/.env +++ b/.env @@ -16,7 +16,6 @@ REACT_APP_MATOMO_TRACKER_URL=matomo.php REACT_APP_MATOMO_ENABLED=false REACT_APP_SWAGGER_URL=https://dev.hel.fi/apis/linkedevents -REACT_APP_SWAGGER_SCHEMA_URL=https://raw.githubusercontent.com/City-of-Helsinki/api-linked-events/master/linked-events.swagger.yaml REACT_APP_INTERNET_PLACE_ID=system:internet REACT_APP_REMOTE_PARTICIPATION_KEYWORD_ID=yso:p26626 diff --git a/Dockerfile b/Dockerfile index 0e726bc9e..5edc1e4c3 100644 --- a/Dockerfile +++ b/Dockerfile @@ -91,8 +91,7 @@ ARG REACT_APP_LINKED_EVENTS_SYSTEM_DATA_SOURCE # Allowed domain for the substitute user ARG REACT_APP_ALLOWED_SUBSTITUTE_USER_DOMAINS -# Swagger URLs -ARG REACT_APP_SWAGGER_SCHEMA_URL +# Swagger URL ARG REACT_APP_SWAGGER_URL # Feature flags diff --git a/README.md b/README.md index 5e41adf00..3e401fa11 100644 --- a/README.md +++ b/README.md @@ -78,7 +78,6 @@ Use .env.development.local for development. | REACT_APP_MATOMO_TRACKER_URL | matomo.php | | REACT_APP_MATOMO_ENABLED | Flag to enable matomo. Default false. | | REACT_APP_SWAGGER_URL | https://dev.hel.fi/apis/linkedevents | -| REACT_APP_SWAGGER_SCHEMA_URL | https://raw.githubusercontent.com/City-of-Helsinki/api-linked-events/master/linked-events.swagger.yaml | | REACT_APP_INTERNET_PLACE_ID | Id of the internet place. system:internet in development server, helsinki:internet in production | | REACT_APP_REMOTE_PARTICIPATION_KEYWORD_ID | yso:p26626 | | REACT_APP_LINKED_EVENTS_SYSTEM_DATA_SOURCE | helsinki | diff --git a/e2e/tests/help.spec.ts b/e2e/tests/help.spec.ts index fb1f4d9e8..6df8c34f7 100644 --- a/e2e/tests/help.spec.ts +++ b/e2e/tests/help.spec.ts @@ -13,74 +13,71 @@ test.describe('Help page', () => { .locator('#page-header') .getByRole('link', { name: 'Tuki' }) .click(); - await page - .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Yleistä' }) - .click(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Alusta' }) + .getByRole('link', { name: 'Tietoa palvelusta' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Alusta' })) + .soft(page.getByRole('heading', { name: 'Tietoa palvelusta' })) .toBeVisible(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Hallintapaneeli' }) + .getByRole('link', { name: 'Käyttöehdot' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Hallintapaneeli' })) + .soft(page.getByRole('heading', { name: 'Tietosuoja ja käyttöehdot' })) .toBeVisible(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Linked Registration -ohje' }) + .getByRole('link', { name: 'Ota yhteyttä' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Linked Registration -ohje' })) + .soft(page.getByRole('heading', { name: 'Ota yhteyttä' })) .toBeVisible(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'UKK' }) + .getByRole('link', { name: 'Pyydä käyttöoikeutta' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Usein kysytyt kysymykset' })) + .soft(page.getByRole('heading', { name: 'Pyydä käyttöoikeutta' })) .toBeVisible(); - await page.getByRole('button', { name: 'Teknologia' }).click(); + await page.getByRole('button', { name: 'Ohjeet' }).click(); await page - .locator('[id="\\/fi\\/help\\/technology-menu"]') - .getByRole('link', { name: 'Yleistä' }) + .getByLabel('Lisätietoa palvelusta') + .getByRole('link', { name: 'Sisällöntuotannon ohjeet' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Yleistä' })) + .soft(page.getByRole('heading', { name: 'Sisällöntuotannon ohjeet' })) .toBeVisible(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Rajapinta' }) + .getByRole('link', { name: 'Ilmoittautumisen ohjeet' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Rajapinta' })) + .soft(page.getByRole('heading', { name: 'Ilmoittautumisen ohjeet' })) .toBeVisible(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Kuvaoikeudet' }) + .getByRole('link', { name: 'UKK' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Kuvaoikeudet' })) + .soft(page.getByRole('heading', { name: 'Usein kysytyt kysymykset' })) .toBeVisible(); + await page.getByRole('button', { name: 'Teknologia' }).click(); await page .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Lähdekoodi' }) + .getByRole('link', { name: 'Lähdekoodi ja rajapinta' }) .click(); await expect - .soft(page.getByRole('heading', { name: 'Lähdekoodi' })) + .soft(page.getByRole('heading', { name: 'Lähdekoodi ja rajapinta' })) .toBeVisible(); await page @@ -90,36 +87,6 @@ test.describe('Help page', () => { await expect .soft(page.getByRole('heading', { name: 'Dokumentaatio' })) .toBeVisible(); - - await page.getByRole('button', { name: 'Tuki' }).click(); - await page - .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Käyttöehdot' }) - .click(); - await expect - .soft(page.getByRole('heading', { name: 'Tietosuoja ja käyttöehdot' })) - .toBeVisible(); - - await page - .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Ota yhteyttä' }) - .click(); - await expect - .soft(page.getByRole('heading', { name: 'Ota yhteyttä' })) - .toBeVisible(); - - await page - .getByLabel('Lisätietoa palvelusta') - .getByRole('link', { name: 'Pyydä käyttöoikeutta' }) - .click(); - await expect - .soft(page.getByRole('heading', { name: 'Pyydä käyttöoikeutta' })) - .toBeVisible(); - - await page.getByLabel('Palvelun ominaisuudet').click(); - await expect - .soft(page.getByRole('heading', { name: 'Palvelun ominaisuudet' })) - .toBeVisible(); }); test('Should submit contact form successfully', async ({ diff --git a/e2e/tests/landing.spec.ts b/e2e/tests/landing.spec.ts index 91b0dd198..95ac3ca6a 100644 --- a/e2e/tests/landing.spec.ts +++ b/e2e/tests/landing.spec.ts @@ -24,7 +24,11 @@ test.describe('Landing page', () => { ) .toBeVisible(); await expect - .soft(page.getByRole('contentinfo').getByRole('link', { name: 'Tuki' })) + .soft( + page + .getByRole('contentinfo') + .getByRole('link', { name: 'Tietoa palvelusta' }) + ) .toBeVisible(); await expect .soft(page.getByRole('link', { name: 'Tietosuoja' })) @@ -77,9 +81,6 @@ test.describe('Landing page', () => { await expect .soft(page.getByRole('link', { name: 'Technology' })) .toBeVisible(); - await expect - .soft(page.getByRole('link', { name: 'Service features' })) - .toBeVisible(); await expect .soft(page.getByRole('link', { name: 'Data Protection' })) .toBeVisible(); @@ -93,7 +94,9 @@ test.describe('Landing page', () => { .toBeVisible(); await expect .soft( - page.getByRole('contentinfo').getByRole('link', { name: 'Support' }) + page + .getByRole('contentinfo') + .getByRole('link', { name: 'Information about the service' }) ) .toBeVisible(); }); diff --git a/package.json b/package.json index 89d38e4d4..7e938dbea 100644 --- a/package.json +++ b/package.json @@ -25,7 +25,6 @@ "@types/react-router": "^5.1.20", "@types/react-router-dom": "^5.3.3", "@types/react-scroll": "^1.8.10", - "@types/swagger-ui-react": "^4.18.3", "@vitejs/plugin-react-swc": "^3.6.0", "apollo-link-rest": "^0.9.0", "apollo-link-sentry": "^3.3.0", @@ -55,6 +54,7 @@ "leaflet-draw": "^1.0.4", "object-keys-normalizer": "^1.0.1", "pretty": "^2.0.0", + "qs": "^6.12.1", "react": "^18.2.0", "react-dom": "^18.2.0", "react-helmet": "^6.1.0", @@ -66,7 +66,6 @@ "react-router-dom": "^6.22.3", "react-scroll": "^1.9.0", "sass": "^1.72.0", - "swagger-ui-react": "^5.12.0", "typescript": "~5.4.3", "use-debounce": "^10.0.0", "use-deep-compare-effect": "^1.8.1", diff --git a/src/assets/images/png/events_instructions_1_EN.png b/src/assets/images/png/events_instructions_1_EN.png new file mode 100644 index 000000000..57e5baec5 Binary files /dev/null and b/src/assets/images/png/events_instructions_1_EN.png differ diff --git a/src/assets/images/png/events_instructions_1_FI.png b/src/assets/images/png/events_instructions_1_FI.png new file mode 100644 index 000000000..5e0f603eb Binary files /dev/null and b/src/assets/images/png/events_instructions_1_FI.png differ diff --git a/src/assets/images/png/events_instructions_1_SV.png b/src/assets/images/png/events_instructions_1_SV.png new file mode 100644 index 000000000..0834e1b5b Binary files /dev/null and b/src/assets/images/png/events_instructions_1_SV.png differ diff --git a/src/assets/images/png/events_instructions_2_EN.png b/src/assets/images/png/events_instructions_2_EN.png new file mode 100644 index 000000000..992357794 Binary files /dev/null and b/src/assets/images/png/events_instructions_2_EN.png differ diff --git a/src/assets/images/png/events_instructions_2_FI.png b/src/assets/images/png/events_instructions_2_FI.png new file mode 100644 index 000000000..24fd26280 Binary files /dev/null and b/src/assets/images/png/events_instructions_2_FI.png differ diff --git a/src/assets/images/png/events_instructions_2_SV.png b/src/assets/images/png/events_instructions_2_SV.png new file mode 100644 index 000000000..d678ad254 Binary files /dev/null and b/src/assets/images/png/events_instructions_2_SV.png differ diff --git a/src/assets/images/png/events_instructions_3_EN.png b/src/assets/images/png/events_instructions_3_EN.png new file mode 100644 index 000000000..83095b44f Binary files /dev/null and b/src/assets/images/png/events_instructions_3_EN.png differ diff --git a/src/assets/images/png/events_instructions_3_FI.png b/src/assets/images/png/events_instructions_3_FI.png new file mode 100644 index 000000000..78b8aee36 Binary files /dev/null and b/src/assets/images/png/events_instructions_3_FI.png differ diff --git a/src/assets/images/png/events_instructions_3_SV.png b/src/assets/images/png/events_instructions_3_SV.png new file mode 100644 index 000000000..29e7aab50 Binary files /dev/null and b/src/assets/images/png/events_instructions_3_SV.png differ diff --git a/src/assets/images/png/events_instructions_4_EN.png b/src/assets/images/png/events_instructions_4_EN.png new file mode 100644 index 000000000..e92cd90aa Binary files /dev/null and b/src/assets/images/png/events_instructions_4_EN.png differ diff --git a/src/assets/images/png/events_instructions_4_FI.png b/src/assets/images/png/events_instructions_4_FI.png new file mode 100644 index 000000000..a4e5f66f5 Binary files /dev/null and b/src/assets/images/png/events_instructions_4_FI.png differ diff --git a/src/assets/images/png/events_instructions_4_SV.png b/src/assets/images/png/events_instructions_4_SV.png new file mode 100644 index 000000000..4bbaba936 Binary files /dev/null and b/src/assets/images/png/events_instructions_4_SV.png differ diff --git a/src/assets/images/png/events_instructions_5_EN.png b/src/assets/images/png/events_instructions_5_EN.png new file mode 100644 index 000000000..adf8285fa Binary files /dev/null and b/src/assets/images/png/events_instructions_5_EN.png differ diff --git a/src/assets/images/png/events_instructions_5_FI.png b/src/assets/images/png/events_instructions_5_FI.png new file mode 100644 index 000000000..e95ed1de5 Binary files /dev/null and b/src/assets/images/png/events_instructions_5_FI.png differ diff --git a/src/assets/images/png/events_instructions_5_SV.png b/src/assets/images/png/events_instructions_5_SV.png new file mode 100644 index 000000000..8ce9de563 Binary files /dev/null and b/src/assets/images/png/events_instructions_5_SV.png differ diff --git a/src/assets/images/png/events_instructions_6_EN.png b/src/assets/images/png/events_instructions_6_EN.png new file mode 100644 index 000000000..12e9dee4c Binary files /dev/null and b/src/assets/images/png/events_instructions_6_EN.png differ diff --git a/src/assets/images/png/events_instructions_6_FI.png b/src/assets/images/png/events_instructions_6_FI.png new file mode 100644 index 000000000..817f56629 Binary files /dev/null and b/src/assets/images/png/events_instructions_6_FI.png differ diff --git a/src/assets/images/png/events_instructions_6_SV.png b/src/assets/images/png/events_instructions_6_SV.png new file mode 100644 index 000000000..7720091fb Binary files /dev/null and b/src/assets/images/png/events_instructions_6_SV.png differ diff --git a/src/assets/images/png/events_instructions_7_EN.png b/src/assets/images/png/events_instructions_7_EN.png new file mode 100644 index 000000000..7383708f5 Binary files /dev/null and b/src/assets/images/png/events_instructions_7_EN.png differ diff --git a/src/assets/images/png/events_instructions_7_FI.png b/src/assets/images/png/events_instructions_7_FI.png new file mode 100644 index 000000000..f29e2ca18 Binary files /dev/null and b/src/assets/images/png/events_instructions_7_FI.png differ diff --git a/src/assets/images/png/events_instructions_7_SV.png b/src/assets/images/png/events_instructions_7_SV.png new file mode 100644 index 000000000..765be8e21 Binary files /dev/null and b/src/assets/images/png/events_instructions_7_SV.png differ diff --git a/src/constants.ts b/src/constants.ts index 32692f142..832885d7a 100644 --- a/src/constants.ts +++ b/src/constants.ts @@ -44,15 +44,12 @@ export enum ROUTES { EDIT_SIGNUP_GROUP = '/registrations/:registrationId/signup-group/edit/:signupGroupId', EVENT_SAVED = '/events/completed/:id', EVENTS = '/events', - FEATURES = '/help/features', HELP = '/help', HOME = '/', IMAGES = '/administration/images', INSTRUCTIONS = '/help/instructions', - INSTRUCTIONS_CONTROL_PANEL = '/help/instructions/control-panel', + INSTRUCTIONS_EVENTS = '/help/instructions/events', INSTRUCTIONS_FAQ = '/help/instructions/faq', - INSTRUCTIONS_GENERAL = '/help/instructions/general', - INSTRUCTIONS_PLATFORM = '/help/instructions/platform', INSTRUCTIONS_REGISTRATION = '/help/instructions/registration', KEYWORDS = '/administration/keywords', KEYWORD_SETS = '/administration/keyword-sets', @@ -68,12 +65,10 @@ export enum ROUTES { SUPPORT = '/help/support', SUPPORT_ASK_PERMISSION = '/help/support/ask-permission', SUPPORT_CONTACT = '/help/support/contact', + SUPPORT_SERVICE_INFORMATION = '/help/support/service-information', SUPPORT_TERMS_OF_USE = '/help/support/terms-of-use', TECHNOLOGY = '/help/technology', - TECHNOLOGY_API = '/help/technology/api', TECHNOLOGY_DOCUMENTATION = '/help/technology/documentation', - TECHNOLOGY_GENERAL = '/help/technology/general', - TECHNOLOGY_IMAGE_RIGHTS = '/help/technology/image-rights', TECHNOLOGY_SOURCE_CODE = '/help/technology/source-code', } diff --git a/src/domain/accessibilityStatement/AccessibilityStatement.tsx b/src/domain/accessibilityStatement/AccessibilityStatement.tsx index 06ffe0b9c..83fb4062e 100644 --- a/src/domain/accessibilityStatement/AccessibilityStatement.tsx +++ b/src/domain/accessibilityStatement/AccessibilityStatement.tsx @@ -1,7 +1,5 @@ /* eslint-disable @typescript-eslint/ban-ts-comment */ /* eslint-disable @typescript-eslint/no-require-imports */ -import 'swagger-ui-react/swagger-ui.css'; - import React from 'react'; import { useTranslation } from 'react-i18next'; import { Link } from 'react-router-dom'; diff --git a/src/domain/admin/layout/__tests__/AdminPageLayout.test.tsx b/src/domain/admin/layout/__tests__/AdminPageLayout.test.tsx index 1dcda374a..5821423fc 100644 --- a/src/domain/admin/layout/__tests__/AdminPageLayout.test.tsx +++ b/src/domain/admin/layout/__tests__/AdminPageLayout.test.tsx @@ -1,13 +1,7 @@ import React from 'react'; import { ROUTES } from '../../../../constants'; -import { - configure, - render, - screen, - userEvent, - waitFor, -} from '../../../../utils/testUtils'; +import { configure, render, screen } from '../../../../utils/testUtils'; import AdminPageLayout from '../AdminPageLayout'; configure({ defaultHidden: true }); @@ -24,15 +18,3 @@ test('should render help page layout', async () => { screen.getByRole('button', { name: 'Hallinta' }); screen.getByRole('link', { name: 'Avainsanat' }); }); - -test('should route to features help page', async () => { - const user = userEvent.setup(); - const { history } = renderComponent(); - - const keywordsLink = screen.getByRole('link', { name: 'Avainsanat' }); - await user.click(keywordsLink); - - await waitFor(() => - expect(history.location.pathname).toBe('/fi/administration/keywords') - ); -}); diff --git a/src/domain/app/footer/Footer.tsx b/src/domain/app/footer/Footer.tsx index 1457db14f..73d6dc682 100644 --- a/src/domain/app/footer/Footer.tsx +++ b/src/domain/app/footer/Footer.tsx @@ -24,7 +24,6 @@ import { useTheme } from '../theme/Theme'; import { navigationGroupAdmin, navigationGroupEvents, - navigationGroupFeatures, navigationGroupHome, navigationGroupInstructions, navigationGroupRegistrations, @@ -106,10 +105,9 @@ const Footer: React.FC = () => { featureFlagUtils.isFeatureEnabled('SHOW_ADMIN') && areAdminRoutesAllowed(user) && navigationGroupAdmin, + navigationGroupSupport, navigationGroupInstructions, navigationGroupTechnology, - navigationGroupSupport, - navigationGroupFeatures, ] .filter(skipFalsyType) .map((group) => ( diff --git a/src/domain/app/footer/__tests__/Footer.test.tsx b/src/domain/app/footer/__tests__/Footer.test.tsx index d1961d7d6..02458f4be 100644 --- a/src/domain/app/footer/__tests__/Footer.test.tsx +++ b/src/domain/app/footer/__tests__/Footer.test.tsx @@ -73,8 +73,7 @@ test('should show navigation links and should route to correct page after clicki { name: 'Hallinta', url: `/fi${ROUTES.ADMIN}` }, { name: /ohjeet/i, url: `/fi${ROUTES.INSTRUCTIONS}` }, { name: /teknologia/i, url: `/fi${ROUTES.TECHNOLOGY}` }, - { name: /tuki/i, url: `/fi${ROUTES.SUPPORT}` }, - { name: /palvelun ominaisuudet/i, url: `/fi${ROUTES.FEATURES}` }, + { name: /tietoa palvelusta/i, url: `/fi${ROUTES.SUPPORT}` }, ]; for (const { name, url } of links) { diff --git a/src/domain/app/footer/__tests__/__snapshots__/Footer.test.tsx.snap b/src/domain/app/footer/__tests__/__snapshots__/Footer.test.tsx.snap index 095524a7d..36d5d9c97 100644 --- a/src/domain/app/footer/__tests__/__snapshots__/Footer.test.tsx.snap +++ b/src/domain/app/footer/__tests__/__snapshots__/Footer.test.tsx.snap @@ -132,59 +132,13 @@ exports[`matches snapshot 1`] = ` > - Instruktioner - - - - - Allmänt - - - - - - Plattform - + Kunskap om tjänsten - Kontrollpanel + Användarvillkor - Linked Registration instruktioner + Kontakta oss - FAQ + Begär åtkomst @@ -261,59 +215,13 @@ exports[`matches snapshot 1`] = ` > - Teknologi - - - - - Allmänt - - - - - - API - + Instruktioner - Bildrättigheter + Instruktioner för innehållsproduktion - Källkod + Registreringsinstruktioner - Dokumentation + FAQ @@ -390,36 +298,13 @@ exports[`matches snapshot 1`] = ` > - Stöd - - - - - Användarvillkor - + Teknologi - Kontakta oss + Källkod och API - Begär åtkomst + Dokumentation -
- The Linked Events API contains event information about the City of - Helsinki's events, courses and volunteer assignments. Some of the - API’s databases have been automatically imported from other - systems and services, and others have been added manually using - the tools on this website. The API provides categorized - information about places and events. You can search for - information by time, keywords, place and region, as well as by - free word search, which searches for an event, course or task in - several different fields. -
-- The API has been developed by the Helsinki City Chancellery's - Linked Events team, which is also responsible for updating the - documentation and maintaining the service. The location - information is linked to the City of Helsinki's Office Register, - which contains e.g. information on accessibility. -
-- The API is constantly evolving. If you have any ideas on how to - improve the API or would like to comment on how it works, please{' '} - contact us - . -
-The API provides results in JSON-LD format.
-
- The API can be found at:{' '}
-
- Linked Events -rajapinta pitää sisällään tapahtumatietoja - Helsingin kaupungin tapahtumista, kursseista ja - vapaaehtoistehtävistä. Osa rajapinnan tietueista on tuotu - automaattisesti muista järjestelmistä ja palveluista, ja muut - lisätty manuaalisesti tämän verkkosivun työkalujen avulla. - Rajapinta tarjoaa kategorisoitua tietoa paikoista ja tapahtumista. - Tietoa voi hakea ajankohdan, avainsanojen, paikan ja alueen mukaan - sekä vapaasanahaulla, joka hakee tapahtuman, kurssin tai tehtävän - useista eri kentistä. -
-- Rajapinnan on kehittänyt Helsingin Kaupunginkanslian Linked - Events-tiimi, joka vastaa myös dokumentaation päivittämisestä ja - palvelun ylläpidosta. Sijaintitiedot linkitetään Helsingin - kaupungin Toimipisterekisteriin, joka sisältää mm. tietoa - esteettömyydestä. -
-- Rajapinta on jatkuvassa kehityksessä. Jos sinulla on ideoita miten - parantaa rajapintaa tai haluat antaa kommentteja sen - toimivuudesta,{' '} - - ota yhteyttä meihin - - . -
-Rajapinta tarjoaa tulokset JSON-LD formaatissa.
-
- Rajapinta löytyy osoitteesta:{' '}
-
- Linked Events API innehåller evenemangsinformation om Helsingfors - stads evenemang, kurser och volontäruppdrag. En del av API's - databaser har automatiskt importerats från andra system och - tjänster, och andra har lagts till manuellt med hjälp av verktygen - på denna webbplats. API'et ger kategoriserad information om - platser och evenemang. Du kan söka efter information efter tid, - nyckelord, plats och region, samt med gratis ordsökning, som söker - efter en evenemang, kurs eller uppgift inom flera olika fält. -
-- API'et har utvecklats av Helsingfors stadskontor Linked - Events-team, som också ansvarar för att uppdatera dokumentationen - och underhålla tjänsten. Platsinformationen är länkad till - Helsingfors stads kontoregister, som innehåller t.ex. information - om tillgänglighet. -
-- API'et utvecklas ständigt.{' '} - - Kontakta oss - {' '} - om du har några idéer om hur du kan förbättra API’et eller vill - kommentera hur det fungerar. . -
-API'et ger resultat i JSON-LD-format.
-
- API'n finns på:{' '}
-
- Linked Events is an event interface for the City of Helsinki. The
- events entered in the interface are automatically submitted to
- e.g.{' '}
-
- The input user interface of the API can be found at{' '}
-
- Events may be entered into the interface with the permission of - the City of Helsinki. Events do not have to be open to everyone, - but restrictions must be clearly stated in the event description. -
-The interface can
-All days of a recurring event can be inputed at once.
-- Event information must be entered at least in Finnish. The - information in Swedish and English should be filled in at large - events suitable for language target groups. Fill in the - information as extensively and accurately as possible. The help - texts on the form will aid you in filling the form. -
-
- Always try to find an image for the event. The image can be marked{' '}
-
- Before uploading an image, edit the image to fit for low bandwith - use and to a 3: 2 horizontal aspect ratio, such as 1200x800 px. It - is essential that the file size remains reasonable for mobile use - as well, preferably less than 200 kilobytes. -
-- To add a recurring event spanning several days, there is an “Add - New Time” button and a “Recurring event” tool to easily add a - recurring event. -
-- The location of the event is selected from the locations of the - city's office register. Address information among other - information is retrieved automatically when the correct location - is found. If you want to add a new location, contact{' '} - {SUPPORT_EMAIL}. -
-- Categorizing an event with keywords is important so that users - using various applications can find the event from a large mass of - events. Choose multiple keywords and favor the ones that have been - previously used in events. Keywords (see YSO Glossary) are most - often found in plural form, e.g. books, families, plays, and - paintings. -
-- The main categories and target groups are primarily for the hel.fi - website, but they are also visible to other services using the - interface. If the event has multiple dates, it may take a while to - save. If you do not receive an error message after pressing the - Publish Event button, wait for a while and the form should advance - to the next view. -
-- Alt text, the alternative text for an image, is a verbal - description of an image for people who, for one reason or another, - cannot see the image themselves. The alt text is a required field. - In the alt text, briefly describe the content of the image, for - example, "Children playing in the yard." Note that alt text is not - a caption. Thus, things that do not appear directly in the image - should not be written down in the alt text. The use of the Alt - text is regulated by the EU-wide Accessibility Directive. Due to - the directive, the filling of the alt text field is mandatory for - each image. -
-- The caption and and author information are optional, but it is - usually still a good idea to fill them out. However, the image - license (see below) may require the name of the author to be - mentioned. It is good practice to enter the name of the author - whenever it is known. Always make sure that you or who you - represent has the right to use the image to market the event. It - is always the responsibility of the image uploader to check the - rights to the image. -
-- It is also the user's responsibility to select the correct - license. -
-
- Unless otherwise agreed with the author or the rights holder of
- the image, select the license "Use limited to the event" for most
- images. The name of the author and / or the other owner of the
- image must always be specified in the field titled “Author”.{' '}
-
- If the image you are using has a more extensive{' '}
-
- Use horizontal images with an aspect ratio of 3:2. The recommended - size for images is 1200 px X 800 px. Images larger than 2 - megabytes cannot be uploaded to the interface. -
-- You can use the old event data for a new event by opening the - event and selecting "Copy as template". My events can be easily - found in Event Management and you have rights to edit them. -
- > - ); - case 'fi': - return ( - <> -
- Linked Events on Helsingin kaupungin tapahtumarajapinta.
- Rajapintaan syötetyt tapahtumat siirtyvät automaattisesti mm.{' '}
-
- Rajapinnan syöttökäyttöliittymä löytyy osoitteesta{' '}
-
- Rajapintaan saa syöttää tapahtumia Helsingin kaupungin luvalla. - Tapahtumien ei tarvitse olla kaikille avoimia, mutta rajoitukset - on kerrottava selkeästi tapahtuman kuvauksessa. -
-Käyttöliittymässä voi
-Toistuvan tapahtuman kaikki päivät voi lisätä samalla kertaa
-- Tapahtuman tiedot on syötettävä ainakin suomeksi. Ruotsin- ja - englanninkieliset tiedot on syytä täyttää suurissa ja - kielikohderyhmille sopivissa tapahtumissa. Täytä tiedot niin - laajasti ja tarkasti kuin mahdollista. Lomakkeen ohjetekstit - avustavat täyttämisessä. -
-
- Pyri aina löytämään tapahtumalle kuva. Kuvalle voi merkitä
- käyttöoikeuden{' '}
-
- Muokkaa kuva ennen syöttöä verkkoon sopivaksi ja - 3:2-vaakakuvasuhteeseen, esimerkiksi 1200x800px. Olennaista on, - että tiedostokoko pysyy kohtuullisena myös mobiilikäyttöön eli - mieluiten alle 200 kilotavua. -
-- Useana päivänä toistuvan tapahtuman lisäämiseksi on Lisää uusi - ajankohta -nappi ja säännöllisesti toistuvalle tapahtumalle oma - Toistuva tapahtuma -työkalu. -
-- Tapahtuman paikka valitaan kaupungin toimipisterekisterin - paikoista. Osoite- ja muut tiedot haetaan siis automaattisesti, - kun oikea paikka löytyy. Jos haluat lisätä uuden toimipisteen, ota - yhteyttä {SUPPORT_EMAIL}. -
-- Tapahtuman luokittelu asiasanoilla on tärkeää, jotta eri - sovellusten käyttäjät löytävät tapahtuman suuresta - tapahtumamassasta. Valitse useampi asiasana ja suosi niitä, joita - on käytetty useissa tapahtumissa. Asiasanat (ks. YSO-sanasto) - löytyvät useimmiten monikkomuodossa, esim. kirjat, perheet, - näytelmät ja maalaukset. -
-- Pääkategoriat ja kohderyhmät ovat ensijaisesti hel.fi-sivustoa - varten, mutta ne näkyvät myös muille rajapinnan hyödyntäjille. Jos - tapahtumalla on useita päivämääräkertoja, voi tallentamisessa - kestää hetken. Jos et saa Julkaise tapahtuma -napin painamisen - jälkeen virheilmoitusta, odota hetki, jolloin lomakkeen pitäisi - siirtyä seuraavaan näkymään. -
-- Alt-teksti eli kuvan vaihtoehtoinen teksti on kuvan sanallinen - kuvailu sellaisille henkilöille, jotka eivät syystä tai toisesta - voi nähdä itse kuvaa. Alt-teksti on pakollinen kenttä. Kuvaile - alt-tekstissä lyhyesti kuvan sisältö, esimerkiksi "Lapsia - leikkimässä pihalla". huomioi, että alt-teksti ei ole kuvateksti. - Alt-tekstissä ei siis saa kertoa sellaisista asioita, jotka eivät - näy suoraan kuvassa. Alt-tekstin käyttöä säätelee EU:n laajuinen - saavutettavuusdirektiivi. Direktiivistä seuraa, että alt-tekstin - syöttäminen on pakollista jokaiselle kuvalle. -
-- Kuvateksti ja kuvaaja eivät ole pakollisia, mutta ne on hyvä - täyttää. Kuvan lisenssissä (katso alta lisää) voidaan kuitenkin - vaatia, että kuvaajan nimi mainitaan. On hyvä käytäntö syöttää - kuvaajan nimi aina jos se on tiedossa. Varmista aina, että sinulla - tai edustamallasi taholla on oikeus käyttää kuvaa tapahtuman - markkinoinnissa. Kuvan käyttöoikeuden varmistaminen on aina kuvan - syöttäjän vastuulla. -
-Myös oikean lisenssin valinta on käyttäjän vastuulla.
-
- Jos kuvaajan tai kuvan oikeudenomistajan kanssa ei ole erikseen
- muuta sovittu, valitse kuvalle lisenssi "Käyttö rajattu tapahtuman
- yhteyteen". Kuvaajan nimi ja/tai muu kuvan oikeudenomistaja pitää
- aina määritellä kohdassa Kuvaaja.{' '}
-
- Jos käyttämälläsi kuvalla on laajempi{' '}
-
- Käytä vaakakuvia, jotka ovat kuvasuhteessa 3:2. Suositeltu mitta - kuville on 1200px X 800px. Yli 2 megatavun kokoisia kuvia ei voi - syöttää rajapintaan. -
-- Uuden tapahtuman tietojen pohjana voi käyttää vanhaa, avaamalla - tapahtuman ja valitsemalla "Kopioi pohjaksi". Omat tapahtumat - löytyvät helposti Tapahtumien hallinnasta ja niihin on - muokkausoikeus. -
- > - ); - case 'sv': - return ( - <> -
- Linked Events är evenemangsgränssnittet för Helsingfors stad. De
- evenemang som anges i gränssnittet överförs automatiskt till t.ex.{' '}
-
- Gränssnittet för inmatning finns på{' '}
-
- Evenemang kan läggas till i gränssnittet med tillstånd av - Helsingfors stad. Evenemang behöver inte vara öppna för alla, men - begränsningar måste anges tydligt i evenemangsbeskrivningen. -
-Med gränssnittet kan man
-- Alla dagar av en återkommande evenemang kan läggas till på en - gång. -
-- Evenemangsinformation måste alltid anges på minst finska. - Informationen på svenska och engelska bör fyllas i vid stora - evenemang som är lämpliga för språkgrupper. Fyll i informationen - så omfattande och exakt som möjligt. Hjälptexterna på formuläret - hjälper dig att fylla i det. -
-
- Försök alltid hitta en bild för evenemanget. Bilden kan markeras{' '}
-
- Innan du laddar upp redigerar du bilden så att den passar internet - och till ett horisontellt bildförhållande 3: 2, t.ex. 1200x800 px. - Det är viktigt att filstorleken förblir rimlig även för mobil - användning, helst mindre än 200 kilobyte. -
-- För att lägga till en flerdagars återkommande evenemang finns - knappen “Lägg till ny tid” och ett verktyg för “återkommande - evenemang”. -
-- Platsen för evenemanget väljs från platserna i stadens - kontoregister. Således hämtas adress och annan information - automatiskt när rätt plats hittas. Om du vill lägga till ett nytt - plats, kontakta{' '} - {SUPPORT_EMAIL}. -
-- Att kategorisera ett evenemang med nyckelord är viktigt så att - användare av olika applikationer kan hitta evenemanget bland en - stor mängd evenemang. Välj flera nyckelord och gynna de som har - använts i flera evenemang. Nyckelord (se YSO-ordlista) finns - oftast i pluralform, t.ex. böcker, familjer, pjäser och målningar. -
-- Huvudkategorierna och målgrupperna är främst för hel.fi - -webbplatsen, men de är också synliga för andra användare av - gränssnittet. Om evenemanget har flera datum kan det ta en stund - att spara. Om du inte får något felmeddelande efter att ha tryckt - på knappen “Publicera evenemang” väntar du på att formuläret - flyttar till nästa vy. -
-- Alt-text, eller alternativ text till en bild, är en verbal - beskrivning av en bild för personer som av en eller annan - anledning inte kan se bilden själva. Alt-text är ett obligatoriskt - fält. Beskriv kortfattat innehållet i bilden i alt-texten, till - exempel "Barn som leker på gården." notera att alt text inte är - textning. Således bör saker som inte visas direkt i bilden inte - berättas i alt-texten. Användningen av Alt-texten regleras av - EU-omfattande tillgänglighetsdirektiv. Det följer av direktivet - att inmatning av alt-text är obligatorisk för varje bild. -
-- Bildtext och författare krävs inte, men de är vanligtvis - fortfarande bra att fylla i. Bildlicensen (se nedan) kan dock - kräva att grafens namn nämns. Det är bra praxis att ange grafens - namn närhelst det är känt. Se alltid till att du eller någon du - representerar har rätt att använda bilden för att marknadsföra - evenemanget. Det är alltid bildladdarens ansvar att säkerställa - åtkomst till bilden. -
-Det är också användarens ansvar att välja rätt licens.
-
- Om inget annat överenskommits med fotografen eller bildens
- rättighetsinnehavare, välj licensen "Använd begränsad till
- evenemangn" för bilden. Namnet på grafen och / eller annan
- rättighetsinnehavare av bilden måste alltid anges i “Författare”
-
- Om bilden du använder har en mer omfattande{' '}
-
- Använd horisontella bilder med bildförhållandet 3:2. Rekommenderad - storlek för bilder är 1200 px X 800 px. Bilder som är större än 2 - megabyte kan inte läggas in i gränssnittet. -
-- Du kan använda informationen från ett äldre evenemang när du ska - skapa ett nytt, genom att öppna evenemanget och välja "Kopiera som - mall". Mina evenemangen hittar du enkelt i Evenemangshantering och - dom har du rättighet att redigera. -
- > - ); - } - }; - - return ( -- The latest documentation for the API in the Open API 2.0 markup + The latest documentation for the API in the Open API 3.0 markup language can be found at:
- Rajapinnan tuorein dokumentaatio Open API 2.0-kuvauskielellä + Rajapinnan tuorein dokumentaatio Open API 3.0-kuvauskielellä löytyy osoitteesta:
Den senaste dokumentationen för gränssnittet i Open API - 2.0-märkningsspråket finns på: + 3.0-märkningsspråket finns på:
@@ -92,11 +85,6 @@ const DocumentationPage: React.FC = () => { title={t('helpPage.pageTitleDocumentation')} /> {getContent(locale)} - -
+ Linked Events is the event interface of the City of Helsinki.
+ Events entered into the interface are automatically transferred to
+ the{' '}
+
+ The interface's input interface can be found at{' '}
+
+ You can enter events into the interface with the permission of the + City of Helsinki. Events do not have to be open to everyone, but + the restrictions must be clearly stated in the event description. +
+In the interface you can
++ All the days of a recurring event can be added at the same time +
+ +To start creating an event, press the Add new event button.
+ {getImage(1, locale)} ++ Event information must be entered at least in Finnish. Swedish and + English should be filled in for large events and events suitable + for language target groups. Fill in the information as widely and + accurately as possible. The help texts on the form will assist you + in filling in the form. +
+ {getImage(2, locale)} + ++ In the Time section, once the dates and times have been entered, + remember to press the Add time button. Otherwise, the desired time + will not be saved in the event data and the event will not be + published. +
++ To add a recurring event, there is an Add date button and a + Recurring event tab for a regularly recurring event. +
+ {getImage(3, locale)} + {getImage(4, locale)} + ++ The venue of the event is chosen from the locations on the city's + register of business locations. The address and other details are + therefore automatically retrieved when the right venue is found. +
+ {getImage(5, locale)} + +
+ Always try to find a image of the event. You can label the image
+ with{' '}
+
+ Before uploading, edit the image to fit the web and to a 3:2 + aspect ratio, for example 1200x800px. It is essential that the + file size remains reasonable also for mobile use, preferably less + than 200 kilobytes. +
++ Alt text, or alternative text to the image, is a verbal + description of the image for people who cannot see the image + itself for one reason or another. Alt text is a required field. In + the alt text, briefly describe the content of the image, e.g. + "Children playing in the yard". The alt text should not be used to + describe things that are not directly visible in the image. The + use of alt text is regulated by the EU-wide Accessibility + Directive. The directive makes it mandatory to include alt text in + every image. +
++ Caption and descriptor are not mandatory, but it is a good idea to + fill them in. However, the image licence (see below for more + details) may require the name of the caption to be included. It is + good practice to enter the name of the photographer whenever it is + known. Always ensure that you or the party you represent has the + right to use the image in the marketing of the event. It is always + the responsibility of the person entering the image to ensure that + they have the right to use it. +
++ It is also the responsibility of the user to choose the correct + licence. +
+
+ Unless otherwise agreed with the photographer or the owner of the
+ rights to the image, choose the licence "Use limited to event".
+ The name of the photographer and/or other rights holder of the
+ image must always be specified in the Photographer section.
+
+ If the image you are using has an extended{' '}
+
+ Use horizontal images with an aspect ratio of 3:2. The recommended + size for images is 1200px X 800px. Images larger than 2 megabytes + cannot be uploaded to the interface. +
+ {getImage(6, locale)} + ++ Classifying an event by keywords is important so that users of + different applications can find the event in a large mass of + events. Choose more than one keyword and give preference to those + that have been used in several events. Keywords (see YSO glossary) + are most often found in plural form, e.g. books, families, plays + and paintings. +
++ The main categories and target groups are primarily for hel.fi, + but are also visible to other users of the interface. If an event + has multiple dates, it may take a while to save. If you do not + receive an error message after pressing the Publish Event button, + please wait a moment, when the form should move to the next + screen. +
+ ++ In the My Events section, you can see lists of events that have + been published or saved in draft form at the organisational level + to which you have access. +
+ {getImage(7, locale)} ++ You can process these events from the three-dot menu at the end of + the event bar: +
++ A cancelled event cannot be edited and a deleted event cannot be + restored. +
+ > + ); + case 'fi': + return ( + <> +
+ Linked Events on Helsingin kaupungin tapahtumarajapinta.
+ Rajapintaan syötetyt tapahtumat siirtyvät automaattisesti mm.{' '}
+
+ Rajapinnan syöttökäyttöliittymä löytyy osoitteesta{' '}
+
+ Rajapintaan saa syöttää tapahtumia Helsingin kaupungin luvalla. + Tapahtumien ei tarvitse olla kaikille avoimia, mutta rajoitukset + on kerrottava selkeästi tapahtuman kuvauksessa. +
+Käyttöliittymässä voi
+Toistuvan tapahtuman kaikki päivät voi lisätä samalla kertaa
++ Aloita tapahtuman luominen painamalla Lisää uusi tapahtuma + -painiketta. +
+ {getImage(1, locale)} ++ Tapahtuman tiedot on syötettävä ainakin suomeksi. Ruotsin- ja + englanninkieliset tiedot on syytä täyttää suurissa ja + kielikohderyhmille sopivissa tapahtumissa. Täytä tiedot niin + laajasti ja tarkasti kuin mahdollista. Lomakkeen ohjetekstit + avustavat täyttämisessä. +
+ {getImage(2, locale)} ++ Ajankohta-kohdassa kun on annettu päivämäärät ja kellonajat, tulee + muistaa painaa Lisää ajankohta - painiketta. Muutoin haluttu + ajankohta ei tallennu tapahtuman tietoihin ja tapahtuman julkaisu + estyy. +
++ Useana päivänä toistuvan tapahtuman lisäämiseksi on Lisää uusi + ajankohta -nappi ja säännöllisesti toistuvalle tapahtumalle oma + Toistuva tapahtuma -työkalu. +
+ {getImage(3, locale)} + {getImage(4, locale)} ++ Tapahtuman paikka valitaan kaupungin toimipisterekisterin + paikoista. Osoite- ja muut tiedot haetaan siis automaattisesti, + kun oikea paikka löytyy. +
+ {getImage(5, locale)} +
+ Pyri aina löytämään tapahtumalle kuva. Kuvalle voi merkitä
+ käyttöoikeuden{' '}
+
+ Muokkaa kuva ennen syöttöä verkkoon sopivaksi ja + 3:2-vaakakuvasuhteeseen, esimerkiksi 1200x800px. Olennaista on, + että tiedostokoko pysyy kohtuullisena myös mobiilikäyttöön eli + mieluiten alle 200 kilotavua. +
++ Alt-teksti eli kuvan vaihtoehtoinen teksti on kuvan sanallinen + kuvailu sellaisille henkilöille, jotka eivät syystä tai toisesta + voi nähdä itse kuvaa. Alt-teksti on pakollinen kenttä. Kuvaile + alt-tekstissä lyhyesti kuvan sisältö, esimerkiksi "Lapsia + leikkimässä pihalla". huomioi, että alt-teksti ei ole kuvateksti. + Alt-tekstissä ei siis saa kertoa sellaisista asioita, jotka eivät + näy suoraan kuvassa. Alt-tekstin käyttöä säätelee EU:n laajuinen + saavutettavuusdirektiivi. Direktiivistä seuraa, että alt-tekstin + syöttäminen on pakollista jokaiselle kuvalle. +
++ Kuvateksti ja kuvaaja eivät ole pakollisia, mutta ne on hyvä + täyttää. Kuvan lisenssissä (katso alta lisää) voidaan kuitenkin + vaatia, että kuvaajan nimi mainitaan. On hyvä käytäntö syöttää + kuvaajan nimi aina jos se on tiedossa. Varmista aina, että sinulla + tai edustamallasi taholla on oikeus käyttää kuvaa tapahtuman + markkinoinnissa. Kuvan käyttöoikeuden varmistaminen on aina kuvan + syöttäjän vastuulla. +
+Myös oikean lisenssin valinta on käyttäjän vastuulla.
+
+ Jos kuvaajan tai kuvan oikeudenomistajan kanssa ei ole erikseen
+ muuta sovittu, valitse kuvalle lisenssi "Käyttö rajattu tapahtuman
+ yhteyteen". Kuvaajan nimi ja/tai muu kuvan oikeudenomistaja pitää
+ aina määritellä kohdassa Kuvaaja.{' '}
+
+ Jos käyttämälläsi kuvalla on laajempi{' '}
+
+ Käytä vaakakuvia, jotka ovat kuvasuhteessa 3:2. Suositeltu mitta + kuville on 1200px X 800px. Yli 2 megatavun kokoisia kuvia ei voi + syöttää rajapintaan. +
+ {getImage(6, locale)} + ++ Tapahtuman luokittelu asiasanoilla on tärkeää, jotta eri + sovellusten käyttäjät löytävät tapahtuman suuresta + tapahtumamassasta. Valitse useampi asiasana ja suosi niitä, joita + on käytetty useissa tapahtumissa. Asiasanat (ks. YSO-sanasto) + löytyvät useimmiten monikkomuodossa, esim. kirjat, perheet, + näytelmät ja maalaukset. +
++ Pääkategoriat ja kohderyhmät ovat ensijaisesti hel.fi-sivustoa + varten, mutta ne näkyvät myös muille rajapinnan hyödyntäjille. Jos + tapahtumalla on useita päivämääräkertoja, voi tallentamisessa + kestää hetken. Jos et saa Julkaise tapahtuma -napin painamisen + jälkeen virheilmoitusta, odota hetki, jolloin lomakkeen pitäisi + siirtyä seuraavaan näkymään. +
+ ++ Omat tapahtumat -osiossa näet listat tapahtumista, jotka on + julkaistu tai tallennettu luonnokseksi organisaatiotasossa, johon + sinulla on käyttöoikeus. +
+ {getImage(7, locale)} ++ Näitä tapahtumia voit käsitellä tapahtumarivin lopusta kolmen + pisteen valikosta: +
++ Peruutettua tapahtumaa ei pysty muokkaamaan eikä poistettua + tapahtumaa pystytä palauttamaan. +
+ > + ); + case 'sv': + return ( + <> +
+ Linked Events är Helsingfors stads gränssnitt för evenemang.
+ Evenemang som registreras i gränssnittet överförs automatiskt till
+ sidan{' '}
+
+ Gränssnittets inmatningsgränssnitt finns på adressen
+
+ Du kan lägga in evenemang i gränssnittet med tillstånd från + Helsingfors stad. Evenemangen behöver inte vara öppna för alla, + men begränsningarna ska tydligt framgå av evenemangsbeskrivningen. +
+I gränssnittet kan du
++ Alla dagar för ett återkommande evenemang kan läggas till + samtidigt +
+ ++ För att börja skapa ett evenemang trycker du på knappen Lägg till + nytt evenemang. +
+ {getImage(1, locale)} ++ Evenemangsuppgifterna ska anges åtminstone på finska. Svenska och + engelska bör fyllas i för stora evenemang och evenemang som lämpar + sig för språkliga målgrupper. Fyll i uppgifterna så mångsidigt och + noggrant som möjligt. Hjälptexterna på blanketten hjälper dig att + fylla i blanketten. +
+ {getImage(2, locale)} ++ När du har angett datum och tid i avsnittet Tid måste du komma + ihåg att trycka på knappen Lägg till tid för evenemang. Annars + sparas inte den önskade tiden i evenemangsdata och evenemanget + publiceras inte. +
++ Om du vill lägga till en återkommande evenemang finns det en knapp + Lägg till tid för evenemang och en flik återkommande evenemang för + en regelbundet återkommande evenemang. +
+ {getImage(3, locale)} + {getImage(4, locale)} + ++ Platsen för evenemanget väljs bland de platser som finns i stadens + register över affärslokaler. Adressen och andra uppgifter hämtas + därför automatiskt när rätt plats hittas. +
+ {getImage(5, locale)} + +
+ Försök alltid att hitta en bild av evenemanget. Du kan märka
+ bilden med{' '}
+
+ Innan du laddar upp bilden ska du redigera den så att den passar + webben och ett bildförhållande på 3:2, till exempel 1200x800px. + Det är viktigt att filstorleken förblir rimlig även för mobil + användning, helst mindre än 200 kilobyte. +
++ Alt-text, eller alternativ text till bilden, är en verbal + beskrivning av bilden för personer som av olika anledningar inte + kan se själva bilden. Alt-text är ett obligatoriskt fält. I + alt-texten ska du kortfattat beskriva bildens innehåll, t.ex. + "Barn som leker på gården". Alt-texten ska inte användas för att + beskriva sådant som inte direkt syns i bilden. Användningen av + alt-text regleras av det EU-omfattande tillgänglighetsdirektivet. + Direktivet gör det obligatoriskt att inkludera alt-text i varje + bild. +
++ Bildtext och fotograf är inte obligatoriska, men det är en god idé + att fylla i dem. Bildlicensen (se nedan för mer information) kan + dock kräva att namnet på bildtexten anges. Det är god praxis att + ange fotografens namn när det är känt. Försäkra dig alltid om att + du eller den du representerar har rätt att använda bilden i + marknadsföringen av evenemanget. Det är alltid den som lägger in + bilden som ansvarar för att säkerställa att han eller hon har rätt + att använda den. +
+Det är också användarens ansvar att välja rätt licens.
+
+ Om inte annat avtalats med fotografen eller den som äger
+ rättigheterna till bilden, välj licensen "Användning begränsad
+ till evenemanget". Namnet på fotografen och/eller annan
+ rättighetsinnehavare till bilden måste alltid anges i avsnittet
+ Fotograf.{' '}
+
+ Om bilden du använder har en utökad{' '}
+
+ Använd horisontella bilder med ett bildförhållande på 3:2. + Rekommenderad storlek på bilder är 1200px X 800px. Bilder som är + större än 2 megabyte kan inte laddas upp till gränssnittet. +
+ {getImage(6, locale)} + ++ Att klassificera ett evenemang med nyckelord är viktigt för att + användare av olika applikationer ska kunna hitta evenemanget i en + stor mängd evenemang. Välj mer än ett nyckelord och ge företräde + åt dem som har använts i flera evenemang. Nyckelord (se YSO:s + ordlista) förekommer oftast i pluralform, t.ex. böcker, familjer, + pjäser och målningar. +
++ Huvudkategorierna och målgrupperna är i första hand avsedda för + hel.fi, men de är också synliga för andra användare av + gränssnittet. Om ett evenemang har flera datum kan det ta en stund + att spara. Om du inte får ett felmeddelande efter att ha tryckt på + knappen Publicera evenemang, vänligen vänta en stund, då + formuläret bör gå till nästa skärm. +
+ ++ I avsnittet Mina evenemangen kan du se listor över evenemangen som + har publicerats eller sparats i utkastform på den + organisationsnivå som du har tillgång till. +
+ {getImage(7, locale)} ++ Du kan bearbeta dessa evenemang från trepunktsmenyn i slutet av + händelsefältet: +
++ En avbruten evenemang kan inte redigeras och en borttagen + evenemang kan inte återställas. +
+ > + ); + } + }; + + return ( +- The Linked Events dashboard lets you enter new events, courses, - and volunteer assignments, and manage related information and - materials. -
-- The public interface allows you to freely search for events for - your own service. You can also suggest a database that should be - linked to Linked Events. -
-- Contact us if you would like more information or have any - suggestions on how we could improve the service. In the Support - section you will find more detailed information and a{' '} - - contact form - - . -
- > - ); - case 'fi': - return ( - <> -- Linked Eventsin hallintapaneelin avulla voit syöttää uusia - tapahtumia, kursseja ja vapaaehtoistehtäviä, sekä hallita niihin - liittyviä tietoja ja materiaaleja. -
-- Julkisen rajapinnan avulla voit vapaasti hakea tapahtumia omaan - palveluusi. Voit myös ehdottaa meille, jos on olemassa jokin - tietopankki, mikä tulisi kytkeä Linked Evensiin. -
-- Ota meihin yhteyttä jos haluat lisätietoa tai sinulla on - ehdotuksia miten voisimme parantaa palvelua. Tuki-osiosta löydät - tarkempaa tietoa ja{' '} - - yhteydenottolomakkeen - - . -
- > - ); - case 'sv': - return ( - <> -- Med instrumentpanelen för Linked Events kan du ange nya evenemang, - kurser och volontäruppgifter och hantera relaterad information och - material. -
-- Det offentliga gränssnittet låter dig fritt söka efter evenemang - för din egen tjänst. Du kan också föreslå för oss om det finns en - databas som ska länkas till Linked Events. -
-- Kontakta oss om du vill ha mer information eller har några förslag - på hur vi kan förbättra tjänsten. I avsnittet Hjälp hittar du mer - detaljerad information och ett{' '} - - kontaktformulär - - . -
- > - ); - } - }; - - return ( -- These Linked Events instructions provide answers to the most common - questions, as well as instructions for using the control panel and - interface. More detailed information about the Linked Events - interface, software and documentation can be found at: -
- ); - case 'fi': - return ( -- Näistä Linked Events ohjeista löydät vastaukset yleisimpiin - kysymyksiin sekä ohjeet hallintapaneelin ja rajapinnan käyttöön. - Tarkemmat tiedot Linked Events-rajapinnasta, -ohjelmistosta ja - -dokumentaatiosta löytyy osoitteista: -
- ); - case 'sv': - return ( -- Dessa instruktioner för Linked Events ger svar på de vanligaste - frågorna samt instruktioner för hur du använder kontrollpanelen och - gränssnittet. Mer detaljerad information om Linked Events - gränssnitt, programvara och dokumentation finns på: -
- ); - } - }; - - return ( -- Linked Events is developed for a Django platform in Python and - Javascript programming languages and utilizes a PostgreSQL database - to capture data. Linked Events Admin is a React-based application - for event management and its and the platform's source code can be - found in Github version control at: -
- ); - case 'fi': - return ( -- Linked Events on kehitetty Django-alustalle Python- ja - Javascript-ohjelmointikielillä ja se hyödyntää - PostgreSQL-tietokantaa tietojen taltioimiseen. Linked Events Admin - on React-pohjainen sovellus tapahtumien hallintaan ja sen sekä - alustan lähdekoodit löytyvät Github-versionhallinnasta osoitteista: -
- ); - case 'sv': - return ( -- Linked Events är utvecklat för Django-plattformen i - programmeringsspråk Python och Javascript och använder en - PostgreSQL-databas för att fånga data. Linked Events Admin är en - React-baserad applikation för evenemangshantering och dess och - plattformens källkod finns i Github-versionskontrollen på: -
- ); - } - }; - return ( -- The City of Helsinki has all the rights to the images. If the - license of the image to be shared in the interface is marked - event_only, the image may only be used for information and - communication about the event. Using images for this purpose is free - for the user. The use or transfer of the image for other purposes is - prohibited. When using images, it is essential to mention the source - and author of the images. -
- ); - case 'fi': - return ( -- Helsingin kaupungilla on kuviin kaikki oikeudet. Mikäli rajapinnassa - jaettavan kuvan tietojen kohdassa license on merkintä event_only, - saa kuvaa käyttää ainoastaan kuvan tapahtumaa käsittelevään - tiedotukseen ja viestintään. Kuvien käyttäminen tähän tarkoitukseen - on käyttäjälle ilmaista. Kuvan käyttö tai siirto muihin - tarkoituksiin on kielletty. Kuvia käytettäessä on ehdottomasti - mainittava kuvien lähde ja kuvaaja. -
- ); - case 'sv': - return ( -- Helsingfors stad har alla rättigheter till bilderna. Om licensen för - bilden som ska delas i gränssnittet är markerad endast evenemang, - får bilden endast användas för information och kommunikation om - bildens evenemang. Att använda bilder för detta ändamål är gratis - för användaren. Användning eller överföring av bilden för andra - ändamål är förbjuden. När du använder bilder är det viktigt att - nämna bildens källa och författare. -
- ); - } - }; - - return ( -{t('helpPage.platformPage.textMainContent1')}
-{t('helpPage.platformPage.textMainContent2')}
-{t('helpPage.platformPage.textMainContent3')}
-{t('helpPage.serviceInformationPage.textMainContent1')}
+{t('helpPage.serviceInformationPage.textMainContent2')}
+{t('helpPage.serviceInformationPage.textMainContent3')}
++ Linked Events is developed for a Django platform in Python and + Javascript programming languages and utilizes a PostgreSQL database + to capture data. Linked Events Admin is a React-based application + for event management and its and the platform's source code can be + found in Github version control at: +
+ ); + case 'fi': + return ( ++ Linked Events on kehitetty Django-alustalle Python- ja + Javascript-ohjelmointikielillä ja se hyödyntää + PostgreSQL-tietokantaa tietojen taltioimiseen. Linked Events Admin + on React-pohjainen sovellus tapahtumien hallintaan ja sen sekä + alustan lähdekoodit löytyvät Github-versionhallinnasta osoitteista: +
+ ); + case 'sv': + return ( ++ Linked Events är utvecklat för Django-plattformen i + programmeringsspråk Python och Javascript och använder en + PostgreSQL-databas för att fånga data. Linked Events Admin är en + React-baserad applikation för evenemangshantering och dess och + plattformens källkod finns i Github-versionskontrollen på: +
+ ); + } + }; + + const getImageRightsContent = (locale: Language) => { + switch (locale) { + case 'en': + return ( + <> ++ The City of Helsinki has all the rights to the images. If the + license of the image to be shared in the interface is marked + event_only, the image may only be used for information and + communication about the event. Using images for this purpose is + free for the user. The use or transfer of the image for other + purposes is prohibited. When using images, it is essential to + mention the source and author of the images. +
+ > + ); + case 'fi': + return ( + <> ++ Helsingin kaupungilla on kuviin kaikki oikeudet. Mikäli + rajapinnassa jaettavan kuvan tietojen kohdassa license on merkintä + event_only, saa kuvaa käyttää ainoastaan kuvan tapahtumaa + käsittelevään tiedotukseen ja viestintään. Kuvien käyttäminen + tähän tarkoitukseen on käyttäjälle ilmaista. Kuvan käyttö tai + siirto muihin tarkoituksiin on kielletty. Kuvia käytettäessä on + ehdottomasti mainittava kuvien lähde ja kuvaaja. +
+ > + ); + case 'sv': + return ( + <> ++ Helsingfors stad har alla rättigheter till bilderna. Om licensen + för bilden som ska delas i gränssnittet är markerad endast + evenemang, får bilden endast användas för information och + kommunikation om bildens evenemang. Att använda bilder för detta + ändamål är gratis för användaren. Användning eller överföring av + bilden för andra ändamål är förbjuden. När du använder bilder är + det viktigt att nämna bildens källa och författare. +
+ > + ); + } + }; + + const getApiContent = (locale: Language) => { switch (locale) { case 'en': return ( <> +- The complete code base of Linked Events can be found in the City - of Helsinki's Github: + The Linked Events API contains event information about the City of + Helsinki's events, courses and volunteer assignments. Some of the + API’s databases have been automatically imported from other + systems and services, and others have been added manually using + the tools on this website. The API provides categorized + information about places and events. You can search for + information by time, keywords, place and region, as well as by + free word search, which searches for an event, course or task in + several different fields.
-- We regularly review development requests and bug reports sent to - Github. + The API has been developed by the Helsinki City Chancellery's + Linked Events team, which is also responsible for updating the + documentation and maintaining the service. The location + information is linked to the City of Helsinki's Office Register, + which contains e.g. information on accessibility. +
++ The API is constantly evolving. If you have any ideas on how to + improve the API or would like to comment on how it works, please{' '} + contact us + . +
+The API provides results in JSON-LD format.
+
+ The API can be found at:{' '}
+
+ Linked Events -rajapinta pitää sisällään tapahtumatietoja + Helsingin kaupungin tapahtumista, kursseista ja + vapaaehtoistehtävistä. Osa rajapinnan tietueista on tuotu + automaattisesti muista järjestelmistä ja palveluista, ja muut + lisätty manuaalisesti tämän verkkosivun työkalujen avulla. + Rajapinta tarjoaa kategorisoitua tietoa paikoista ja tapahtumista. + Tietoa voi hakea ajankohdan, avainsanojen, paikan ja alueen mukaan + sekä vapaasanahaulla, joka hakee tapahtuman, kurssin tai tehtävän + useista eri kentistä. +
++ Rajapinnan on kehittänyt Helsingin Kaupunginkanslian Linked + Events-tiimi, joka vastaa myös dokumentaation päivittämisestä ja + palvelun ylläpidosta. Sijaintitiedot linkitetään Helsingin + kaupungin Toimipisterekisteriin, joka sisältää mm. tietoa + esteettömyydestä. +
- Linked Eventsin koodikanta löytyy kokonaisuudessaan Helsingin - kaupungin Githubista: + Rajapinta on jatkuvassa kehityksessä. Jos sinulla on ideoita miten + parantaa rajapintaa tai haluat antaa kommentteja sen + toimivuudesta,{' '} + + ota yhteyttä meihin + + .
-Rajapinta tarjoaa tulokset JSON-LD formaatissa.
- Käymme läpi säännöllisesti Githubiin lähetettyjä kehitystoiveita
- ja virheraportteja.
+ Rajapinta löytyy osoitteesta:{' '}
+
+ Linked Events API innehåller evenemangsinformation om Helsingfors + stads evenemang, kurser och volontäruppdrag. En del av API's + databaser har automatiskt importerats från andra system och + tjänster, och andra har lagts till manuellt med hjälp av verktygen + på denna webbplats. API'et ger kategoriserad information om + platser och evenemang. Du kan söka efter information efter tid, + nyckelord, plats och region, samt med gratis ordsökning, som söker + efter en evenemang, kurs eller uppgift inom flera olika fält. +
++ API'et har utvecklats av Helsingfors stadskontor Linked + Events-team, som också ansvarar för att uppdatera dokumentationen + och underhålla tjänsten. Platsinformationen är länkad till + Helsingfors stads kontoregister, som innehåller t.ex. information + om tillgänglighet. +
++ API'et utvecklas ständigt.{' '} + + Kontakta oss + {' '} + om du har några idéer om hur du kan förbättra API’et eller vill + kommentera hur det fungerar. . +
+API'et ger resultat i JSON-LD-format.
+
+ API'n finns på:{' '}
+
- Den kompletta kodbasen för Linked Events finns i Helsingfors stads - Github: + The Linked Events user interface lets you enter new events, + courses, and volunteer assignments, and manage related information + and materials.
-- Vi granskar regelbundet utvecklingsförfrågningar och felrapporter - som skickas till Github. + Linked Eventsin käyttöliittymän avulla voit syöttää uusia + tapahtumia, kursseja ja vapaaehtoistehtäviä, sekä hallita niihin + liittyviä tietoja ja materiaaleja. +
+ > + ); + case 'sv': + return ( + <> ++ Med Linked Events användargränssnittet kan du ange nya evenemang, + kurser och volontäruppgifter och hantera relaterad information och + material.
> ); } }; + return (