# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Matomo Reporting API for plugin Languages Manager API
  version: 1.0.0
extends: openapi/matomo-languagesmanager-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/index.php?module=API&method=LanguagesManager.isLanguageAvailable'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a language code is available
      effect: read
      questions:
      - Is a given language code supported in my Matomo instance?
      - Can I use German as an interface language here?
      instructions:
      - text: Check whether language code {languageCode} is available.
        slots:
          languageCode: query.languageCode
      - text: Tell me if {languageCode} can be used as a UI language.
        slots:
          languageCode: query.languageCode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.getAvailableLanguages'].get
  update:
    x-apievangelist-phrasing:
      intent: List available language codes
      effect: read
      questions:
      - Which language codes can the interface be shown in?
      - What languages are installed on this instance?
      instructions:
      - text: List the available language codes.
      - text: Show me every installed interface language code.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.getAvailableLanguagesInfo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get translation coverage per language
      effect: read
      questions:
      - How complete is the translation for each available language?
      - Can I check translation coverage while excluding non-core plugins?
      instructions:
      - text: Show translation coverage for each available language.
      - text: Report language completeness with excludeNonCorePlugins set to {excludeNonCorePlugins}.
        slots:
          excludeNonCorePlugins: query.excludeNonCorePlugins
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.getAvailableLanguageNames'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages with native and English names
      effect: read
      questions:
      - What are the localized and English names of each available language?
      - Can I get language names to show in a language picker?
      instructions:
      - text: List available languages with their localized and English names.
      - text: Give me display names for every installed language.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.getTranslationsForLanguage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get all translation strings for a language
      effect: read
      questions:
      - Can I download every translation string for one language?
      - Where do I get core and plugin translations for French?
      instructions:
      - text: Get all translation strings for language {languageCode}.
        slots:
          languageCode: query.languageCode
      - text: Export the {languageCode} translations across core and loaded plugins.
        slots:
          languageCode: query.languageCode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.getLanguageForUser'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's language preference
      effect: read
      questions:
      - What interface language has a particular user chosen?
      - Can I check which language a teammate sees the UI in?
      instructions:
      - text: Get the saved language for user {login}.
        slots:
          login: query.login
      - text: Tell me which UI language {login} uses.
        slots:
          login: query.login
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.setLanguageForUser'].get
  update:
    x-apievangelist-phrasing:
      intent: Set a user's language preference
      effect: write
      questions:
      - How do I change the interface language for another user?
      - Can I store a language preference for a specific login?
      instructions:
      - text: Set the language for user {login} to {languageCode}.
        slots:
          login: query.login
          languageCode: query.languageCode
      - text: Switch {login}'s interface to {languageCode}.
        slots:
          login: query.login
          languageCode: query.languageCode
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.uses12HourClockForUser'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a user prefers a 12-hour clock
      effect: read
      questions:
      - Does a given user see times in 12-hour AM/PM format?
      - Which time format has a particular user chosen?
      instructions:
      - text: Check whether user {login} uses the 12-hour clock.
        slots:
          login: query.login
      - text: Tell me {login}'s time format preference.
        slots:
          login: query.login
      method: generated
      generated: '2026-10-01'
- target: $.paths['/index.php?module=API&method=LanguagesManager.set12HourClockForUser'].get
  update:
    x-apievangelist-phrasing:
      intent: Set a user's 12-hour clock preference
      effect: write
      questions:
      - Can I switch a user to 24-hour time formatting?
      - How do I save an AM/PM time preference for someone's account?
      instructions:
      - text: Set use12HourClock to {use12HourClock} for user {login}.
        slots:
          use12HourClock: query.use12HourClock
          login: query.login
      - text: Turn the 12-hour clock on for {login}.
        slots:
          login: query.login
      method: generated
      generated: '2026-10-01'