Merge branch 'main' of github.com:strapi/documentation

Author: pwizla

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,25 +1,24 @@
 <!--
-Hello 👋 Thank you for submitting a pull request.
+Hello 👋 Thank you for submitting a pull request!
 
-To help us merge your PR, make sure to follow the instructions below:
+To help us merge your PR, make sure to follow the instructions detailed in the Contributing Guide: 
+https://github.com/strapi/documentation/blob/main/CONTRIBUTING.md
 
-- Create or update the documentation. (Should be made against the `main` branch)
-- Create or update the tests.
-- Refer to the issue you are closing in the PR description - fix #issue
-- Specify if the PR is in WIP (work in progress) state or ready to be merged
+Note that all documentation updates should be made against the `main` branch.
+Keep your PR in Draft mode until it's ready to be reviewed and merged.
 
-Please ensure you read through the Contributing Guide: 
-https://github.com/strapi/documentation/blob/main/CONTRIBUTING.md
--->
 
-### What does it do?
+As part of the Docs Contribution Program, all external contribution PRs are labeled `contribution`.
+Feel free to read more details on the Contribution Program in the dedicated guide:
+https://strapi.notion.site/Documentation-Contribution-Program-1d08f359807480d480fdde68bb7a5a71
 
-Describe the technical changes you did.
+Let us know if you do not wish to take part in the Docs Contribution Program, and remove the `contribution` label.
+-->
 
-### Why is it needed?
+### Description
 
-Describe the issue you are solving.
+Describe the changes you did: What does it do? Why is it needed?
 
 ### Related issue(s)/PR(s)
 
-Let us know if this is related to any issue/pull request
+Let us know if this is related to any issue/pull request or contribution idea suggested by the Docs team.

CONTRIBUTING.md

@@ -17,6 +17,8 @@ Contributing to the Strapi documentation implies 2 steps:
 
 2. [Submit a pull request](#-pull-requests) for review.
 
+By default, all external contributions are automatically labeled `contribution` to be apart of the [Docs Contribution Program](https://strapi.notion.site/Documentation-Contribution-Program-1d08f359807480d480fdde68bb7a5a71), which rewards contributors with points (based on the amount of updates in the pull request) that can then be used in the Strapi Shop to get Strapi goodies. If you do not wish to take part in the program, let the Strapi Documentation team know and the `contribution` label will be removed from your pull request.
+
 ## 🦖 Docusaurus
 
 Strapi’s documentation is built with the React- and Markdown-based [Docusaurus](https://docusaurus.io) framework.
@@ -98,6 +100,7 @@ To submit your contribution for review:
 
 That’s it! 🥳 Once the pull request is [reviewed and approved](#review-and-management-of-pull-requests), the Strapi Documentation team will merge it, and the content will be live on [docs.strapi.io](http://docs.strapi.io) a few minutes later. 🚀
 
+If your contribution takes part in the [Docs Contribution Program](https://strapi.notion.site/Documentation-Contribution-Program-1d08f359807480d480fdde68bb7a5a71), as soon as your pull request is merged, you should receive an email with a link to the Strapi Shop where points you have earned will have been granted to your account.
 
 ## Review and management of pull requests
 

docusaurus/docs/cms/features/internationalization.md

@@ -11,6 +11,8 @@ tags:
 - features
 ---
 
+import StrapiAiCredits from '/docs/snippets/strapi-ai-credits.md'
+
 # Internationalization (i18n)
 
 <Tldr>
@@ -83,6 +85,21 @@ It is not possible to create custom locales. Locales can only be created based o
  }}
 />
 
+#### Enabling AI-powered internationalization
+<GrowthBadge /> 
+
+AI-Powered Internationalization enables automatic translations for all the locales in a project when the content in the default locale is updated. This enables content editors to have their content translated into multiple languages within a few seconds.
+
+AI-powered Internationalization is disabled by default. To enable it, go to <Icon name="gear-six" /> *Settings > Global Settings > Internationalization* and set <Icon name="sparkle" /> _AI Translations_ to _Enabled_.
+
+<ThemedImage
+ alt="Internationalization settings"
+ sources={{
+ light: '/img/assets/settings/i18n-with-ai.png',
+ dark: '/img/assets/settings/i18n-with-ai_DARK.png',
+ }}
+/>
+
 ### Code-based configuration
 
 A `STRAPI_PLUGIN_I18N_INIT_LOCALE_CODE` [environment variable](/cms/configurations/environment#strapi) can be configured to set the default locale for your environment. The value used for this variable should be an ISO country code from <ExternalLink to="https://github.com/strapi/strapi/blob/main/packages/plugins/i18n/server/src/constants/iso-locales.json" text="the 500+ pre-created list of locales"/>.
@@ -105,10 +122,6 @@ To translate content in another locale:
 2. Choose the locale in which you want to translate your content.
 3. Translate your content by filling up your content-type's fields. 
 
-:::tip
-Click on the <Icon name="download-simple" /> *Fill in from another locale* button, in the top right corner, for all non relational fields to be filled up with the values of another chosen locale. It can be useful if you do not remember what was the exact content in another locale.
-:::
-
 <ThemedImage
  alt="Managing locales with i18n"
  sources={{
@@ -117,6 +130,33 @@ Click on the <Icon name="download-simple" /> *Fill in from another locale* butto
  }}
 />
 
+:::tip
+Click on the <Icon name="globe-hemisphere-west" /> *Fill in from another locale* button, in the top right corner, for all non relational fields to be filled up with the values of another chosen locale. It can be useful if you do not remember what was the exact content in another locale. This button is not visible if you've enabled [AI-powered internationalization](#ai-powered-internationalization) since translations are automatically handled by Strapi AI.
+:::
+
+### AI-powered internationalization <NewBadge /> {#ai-powered-internationalization}
+<GrowthBadge /> 
+
+[When enabled](#enabling-ai-powered-internationalization), AI-powered internationalization enables automatic translations for all the locales in a project when the source content is updated. This enables content editors to have their content translated into multiple languages within a few seconds. The idea behind the feature is to ensure users only manually fill in content in the default locale, and Strapi AI translates it for all other existing locales.
+
+Once enabled, whenever you edit a content-type in the default locale and click **Save**, all other locales for the content-type should be translated automatically, which will be confirmed by an _All locales have been translated_ notification. Using this feature consumes Strapi AI credits.
+
+<ThemedImage
+ alt="Managing locales with AI-powered i18n"
+ sources={{
+ light: '/img/assets/content-manager/locale-i18n-with-ai.png',
+ dark: '/img/assets/content-manager/locale-i18n-with-ai_DARK.png',
+ }}
+/>
+
+:::caution
+AI-powered internationalization only works one way, keeping the default locale content as the unique source of truth. Consequently, once the feature is enabled:
+- Editing and saving content for any locale othen than the default one will not trigger automatic translations.
+- When editing the content for the default locale, the manual modifications made to other locales will be overwritten.
+:::
+
+<StrapiAiCredits />
+
 ### Usage with APIs
 
 Localized content can be requested, created, updated, and deleted for a given locale through the various front-end APIs accessible from [Strapi's Content API](/cms/api/content-api):

docusaurus/docs/release-notes.md

@@ -28,6 +28,52 @@ New versions (minor or patch) are generally released weekly, on Wednesdays.
 </details>
 
 
+## 6.10.0
+
+<br />
+### <Icon name='sparkle' /> New content
+
+<br />
+
+#### Repository
+- [Replace Algolia search with MeiliSearch](https://github.com/strapi/documentation/pull/2783)
+- [Add a "News Ticker" to homepage](https://github.com/strapi/documentation/pull/2766)
+
+### <Icon name='pen-nib' /> Updated content
+
+<br />
+
+#### CMS
+- [Add rate limiting documentation for users-permissions plugin](https://github.com/strapi/documentation/pull/2782)
+
+#### Repository
+- [Add contribution program links to footer and top nav](https://github.com/strapi/documentation/pull/2781)
+
+### <Icon name='broom' /> Chore, fixes, typos, and other improvements
+
+<br />
+
+#### Repository
+- [Fix S key in Ask AI modal triggering the MeiliSearch modal](https://github.com/strapi/documentation/pull/2786)
+- [Docs Contribution Program: updates in PR template & contribution guide](https://github.com/strapi/documentation/pull/2784)
+
+***
+This release was made possible thanks to the following contributors. Thank you! 🫶
+<div>
+<a href="https://github.com/crasite" target="_blank">
+ <img className="no-zoom" src="https://avatars.githubusercontent.com/u/9783406?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="crasite"/>
+</a>
+<a href="https://github.com/meganelacheny" target="_blank">
+ <img className="no-zoom" src="https://avatars.githubusercontent.com/u/19183360?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="meganelacheny"/>
+</a>
+<a href="https://github.com/pwizla" target="_blank">
+ <img className="no-zoom" src="https://avatars.githubusercontent.com/u/4233866?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="pwizla"/>
+</a>
+</div>
+<br/>
+<br/>
+
+
 ## 6.9.5
 
 <br />

docusaurus/package.json

@@ -1,6 +1,6 @@
 {
  "name": "strapi-docs",
- "version": "6.9.5",
+ "version": "6.10.0",
  "private": true,
  "scripts": {
  "docusaurus": "docusaurus",

docusaurus/sidebars.js

@@ -90,6 +90,9 @@ const sidebars = {
  type: 'doc',
  label: 'Internationalization (i18n)',
  id: 'cms/features/internationalization',
+ customProps: {
+ updated: true,
+ },
  },
  {
  type: 'doc',

docusaurus/src/components/NewsTicker/index.js

@@ -0,0 +1,79 @@
+import React, { useState, useEffect } from 'react';
+import styles from './styles.module.scss';
+import clsx from 'clsx';
+import Icon from '@site/src/components/Icon';
+
+const NewsTicker = ({ newsItems, interval = 5000 }) => {
+ const [currentIndex, setCurrentIndex] = useState(0);
+ const [isFading, setIsFading] = useState(false);
+ const [isPaused, setIsPaused] = useState(false);
+
+ const handleNavigation = (newIndex) => {
+ const isWrapping = 
+ (currentIndex === newsItems.length - 1 && newIndex === 0) ||
+ (currentIndex === 0 && newIndex === newsItems.length - 1);
+
+ if (isWrapping) {
+ setIsFading(true);
+ setTimeout(() => {
+ setCurrentIndex(newIndex);
+ setIsFading(false);
+ }, 250); // Half of the fade animation duration
+ } else {
+ setCurrentIndex(newIndex);
+ }
+ };
+
+ // Auto-rotation effect
+ useEffect(() => {
+ if (isPaused || newsItems.length <= 1) {
+ return; // Do nothing if paused or not enough items
+ }
+
+ const timer = setInterval(() => {
+ handleNavigation((currentIndex + 1) % newsItems.length);
+ }, interval);
+
+ return () => clearInterval(timer);
+ }, [isPaused, currentIndex, newsItems, interval]);
+
+ if (!newsItems || newsItems.length === 0) {
+ return null;
+ }
+
+ return (
+ <div 
+ className={clsx(styles.newsTicker, 'news-ticker-container', isFading && styles.isFading)}
+ onMouseEnter={() => setIsPaused(true)}
+ onMouseLeave={() => setIsPaused(false)}
+ >
+ <div className={styles.contentViewport}>
+ <div className={styles.filmStrip} style={{ transform: `translateX(-${currentIndex * 100}%)` }}>
+ {newsItems.map((item, index) => (
+ <div key={index} className={styles.newsItem}>
+ <a href={item.link} target="_blank" rel="noopener noreferrer">
+ {item.icon && <Icon name={item.icon} classes="ph-fill" />}
+ <span>{item.text}</span>
+ </a>
+ </div>
+ ))}
+ </div>
+ </div>
+
+ {newsItems.length > 1 && (
+ <div className={styles.dotsContainer}>
+ {newsItems.map((_, index) => (
+ <button
+ key={index}
+ className={clsx(styles.dot, { [styles.active]: currentIndex === index })}
+ onClick={() => handleNavigation(index)}
+ aria-label={`Go to news item ${index + 1}`}
+ />
+ ))}
+ </div>
+ )}
+ </div>
+ );
+};
+
+export default NewsTicker;

docusaurus/src/components/NewsTicker/styles.module.scss

@@ -0,0 +1,89 @@
+.newsTicker {
+ background-color: var(--ifm-background-color);
+ padding: 1.25rem 2rem;
+ display: flex;
+ align-items: center;
+ width: 100%;
+ gap: 1.5rem;
+ transition: opacity 0.25s ease-in-out;
+
+ &.isFading {
+ opacity: 0;
+ }
+}
+
+.contentViewport {
+ flex-grow: 1;
+ min-width: 0;
+ overflow: hidden;
+}
+
+.filmStrip {
+ display: flex;
+ transition: transform 0.5s ease-in-out;
+}
+
+.newsItem {
+ flex: 0 0 100%;
+ display: flex;
+ justify-content: center;
+ align-items: center;
+
+ a {
+ display: flex;
+ align-items: center;
+ gap: 0.75rem;
+ font-weight: 500;
+ color: var(--ifm-font-color-base);
+ text-decoration: none;
+ white-space: normal;
+ text-align: left;
+ transition: color 0.3s ease;
+
+ i {
+ font-size: 1.25rem;
+ color: var(--ifm-font-color-base);
+ flex-shrink: 0;
+ transition: color 0.3s ease;
+ }
+
+ &:hover,
+ &:hover i {
+ color: var(--news-ticker-hover-color);
+ }
+ }
+}
+
+.dotsContainer {
+ display: flex;
+ gap: 0.5rem;
+ flex-shrink: 0;
+}
+
+.dot {
+ width: 8px;
+ height: 8px;
+ border-radius: 50%;
+ background-color: var(--ifm-color-emphasis-300);
+ border: none;
+ padding: 0;
+ cursor: pointer;
+ transition: background-color 0.3s ease;
+
+ &.active {
+ background-color: var(--news-ticker-active-dot-color);
+ }
+}
+
+// Mobile-specific adjustments
+@media (max-width: 996px) {
+ .newsTicker {
+ padding-left: 1rem;
+ padding-right: 1rem;
+ gap: 1rem;
+ }
+
+ .newsItem {
+ justify-content: flex-start;
+ }
+}

docusaurus/src/pages/home/Home.jsx

@@ -18,6 +18,7 @@ import {
  HeroTitle,
  HomepageAIButton,
 } from '../../components';
+import NewsTicker from '@site/src/components/NewsTicker';
 import Icon from '../../components/Icon';
 import content from './_home.content';
 
@@ -136,6 +137,7 @@ export default function PageHome() {
  }}
  />
  <main className={clsx(styles.home, isDarkTheme ? styles.homeDark : '')}>
+ <NewsTicker newsItems={content.newsTicker} />
  <Hero id="homeHero" className={isDarkTheme ? styles.heroDark : ''}>
  <Container>
  <HeroTitle className="heroTitle">