withstudiocms · dreyfus92 · Mar 31, 2025 · Mar 30, 2025 · Mar 30, 2025
@@ -11,7 +11,7 @@ import ContributorList from '~/components/ContributorList.astro';
 
 Lee nuestro [Código de Conducta](https://github.com/withstudiocms/studiocms?tab=coc-ov-file#code-of-conduct-) para mantener nuestra comunidad accesible y respetable.
 
-¡Damos la bienvenida a las contribuciones de la comunidad! Ya sean reportes de errores, solicitudes de funcionalidades o contribuciones de código, agradecemos tu ayuda para mejorar este proyecto. Para navegar por nuestro código base con confianza, consulta la sección [Cómo funciona](/es/how-it-works/).
+¡Damos la bienvenida a las contribuciones de la comunidad! Ya sean reportes de errores, solicitudes de funcionalidades o contribuciones de código, agradecemos tu ayuda para mejorar este proyecto. Para navegar por nuestro código base con confianza, consulta la sección [Cómo funciona][how-it-works].
 
 ## Nuestros contribuyentes
 
@@ -23,3 +23,5 @@ Nuestro proyecto existe gracias a todas las personas que contribuyen. [Únete a
 
 Si encuentras un error o deseas sugerir una nueva funcionalidad, por favor abre un issue en nuestro [repositorio de GitHub](https://github.com/withstudiocms/studiocms). Al crear un nuevo issue, proporciona tantos detalles como sea posible, incluyendo los pasos para reproducir el problema (para errores) y una descripción clara de la funcionalidad propuesta.
 
+{/* Enlaces */}
+[how-it-works]: /es/how-it-works/
@@ -40,3 +40,4 @@ Estos endpoints son accesibles al público y no requieren autenticación. Propor
 - **`/studiocms_api/rest/v1/settings/`**: Proporciona la configuración de StudioCMS para el proyecto actual.
 - **`/studiocms_api/rest/v1/users/`**: Proporciona una lista de todos los usuarios en el proyecto StudioCMS.
 - **`/studiocms_api/rest/v1/users/[id]`**: Proporciona detalles de un usuario específico en el proyecto StudioCMS.
+
@@ -76,3 +76,4 @@ Esta integración de Astro permite el seguimiento del rendimiento del sitio web
 {/* ## Galería de Demostración
 
 <Gallery galleryImages={webVitalsImages} /> */}
+
@@ -23,4 +23,4 @@ Cualquier paquete etiquetado como <Badge text="Uso Público" variant="caution"/>
 ### Paquetes de la Comunidad
 ---
 
-<PackageCatalog catalog="community" />
+<PackageCatalog catalog="community" />
@@ -25,7 +25,7 @@ Este plugin habilita las características del Blog de StudioCMS así como un fro
 
 2. Añade `@studiocms/blog` a tu archivo de configuración de Astro:
 
-   ```ts title="studiocms.config.mjs" ins={2, 6}
+   ```ts twoslash title="studiocms.config.mjs" ins={2, 6}
    import { defineStudioCMSConfig } from 'studiocms/config';
    import blog from '@studiocms/blog';
 

@@ -139,14 +139,20 @@ type StudioCMSPlugin = {
      */
     fields: SettingsField[];
 
-    /**
-     * Función que se ejecuta cuando se guarda la página de configuración
-     *
-     * Debe devolver una cadena si hay un error,
-     * de lo contrario devuelve true booleano para indicar éxito
-     */
-    onSave: APIRoute;
+		/**
+     * El endpoint para la configuración
+		 *
+     * Debería exportar un APIRoute llamado `onSave` que se ejecute cuando se guarde la página de configuración
+		 */
+		endpoint: string,
   } | undefined;
+  	/**
+     * Enlaces de navegación para usar con el complemento `@studiocms/blog` y otros complementos para mostrar enlaces en el frontend
+	   */
+  frontendNavigationLinks: Array<{
+    label: string;
+    href: string;
+  }>;
 
   /**
    * Definición del tipo de página. Si está presente, el complemento quiere poder modificar el proceso de creación de páginas
@@ -183,6 +189,8 @@ type StudioCMSPlugin = {
      * El componente debe tener una prop `content` que sea una cadena para poder mostrar el contenido actual.
      *
      * **NOTA:** Actualmente, requiere que uses el id de formulario `page-content` para la salida de contenido. Tu editor también debe poder manejar el envío de formularios.
+     * 
+     * **NOTA:** ¡Puedes usar `studiocms/markdown` o `studiocms/html` como valor de reserva si estás trabajando con contenido html o markdown!
      *
      * @example
      * ```ts
@@ -194,7 +202,51 @@ type StudioCMSPlugin = {
      * }
      * ```
      */
-    pageContentComponent: string;
+    pageContentComponent: 'studiocms/markdown' | 'studiocms/html' | string;
+
+		/**
+     * La ruta al componente real que se muestra para el renderizador de la página
+     * 
+     * **NOTA:** ¡Puedes usar `studiocms/markdown` o `studiocms/html` como valor de reserva si estás trabajando con contenido html o markdown!
+		 */
+		rendererComponent: 'studiocms/markdown' | 'studiocms/html' | string;
+
+    /**
+     * Campos según la especificación
+     */
+    fields: SettingsField[];
+
+		/**
+     * Endpoint de API para el tipo de página
+		 *
+     * Los endpoints de API se utilizan para crear, editar y eliminar páginas de este tipo,
+     * los endpoints serán proporcionados el contexto completo de la API de Astro desde el APIRoute de Astro.
+		 *
+     * El archivo debe exportar al menos uno de los siguientes:
+		 * - `onCreate`
+		 * - `onEdit`
+		 * - `onDelete`
+		 *
+		 * @example
+		 * ```ts
+		 * // my-plugin.ts
+		 * import { createResolver } from 'astro-integration-kit';
+		 * const { resolve } = createResolver(import.meta.url)
+		 *
+		 * {
+		 *  apiEndpoint: resolve('./api/pageTypeApi.ts'),
+		 * }
+		 *
+		 * // api/pageTypeApi.ts
+		 * import { APIRoute } from 'astro';
+		 *
+		 * export const onCreate: APIRoute = async (ctx) => {
+     *  // Lógica personalizada aquí
+		 *   return new Response();
+		 * }
+		 * ```
+		 */
+		apiEndpoint: string;
   }> | undefined;
 };
 ```
@@ -239,4 +291,8 @@ export const myPlugin = (options: Options) => definePlugin({
 
 En este ejemplo, definimos un complemento de StudioCMS llamado `My Plugin` que requiere la versión `0.1.0-beta.8` o superior de StudioCMS. El complemento también proporciona una Integración Astro que registra un mensaje en la consola cuando se llama al hook `astro:config:setup`.
 
-<ReadMore>Para más información sobre la creación de plugins, consulta la Guía [Haciendo Plugins Útiles](/es/plugins/extended)</ReadMore>
+<ReadMore>Para más información sobre la creación de plugins, consulta la Guía [Haciendo Plugins Útiles][reference-page]</ReadMore>
+
+{/* Enlaces */}
+
+[reference-page]: /es/plugins/reference/
Original file line number	Diff line number	Diff line change
Expand Up		@@ -40,3 +40,4 @@ Estos endpoints son accesibles al público y no requieren autenticación. Propor
		- `/studiocms_api/rest/v1/settings/`: Proporciona la configuración de StudioCMS para el proyecto actual.
		- `/studiocms_api/rest/v1/users/`: Proporciona una lista de todos los usuarios en el proyecto StudioCMS.
		- `/studiocms_api/rest/v1/users/[id]`: Proporciona detalles de un usuario específico en el proyecto StudioCMS.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -76,3 +76,4 @@ Esta integración de Astro permite el seguimiento del rendimiento del sitio web
		{/* ## Galería de Demostración

		<Gallery galleryImages={webVitalsImages} /> */}