feat: adds UI control to unpublish the current locale

packages/db-mongodb/src/createGlobalVersion.ts

@@ -17,6 +17,7 @@ export const createGlobalVersion: CreateGlobalVersion = async function createGlo
     req,
     returning,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     versionData,
   },
@@ -36,6 +37,7 @@ export const createGlobalVersion: CreateGlobalVersion = async function createGlo
     parent,
     publishedLocale,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     version: versionData,
   }

packages/db-mongodb/src/createVersion.ts

@@ -17,6 +17,7 @@ export const createVersion: CreateVersion = async function createVersion(
     req,
     returning,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     versionData,
   },
@@ -40,6 +41,7 @@ export const createVersion: CreateVersion = async function createVersion(
     parent,
     publishedLocale,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     version: versionData,
   }

packages/drizzle/src/createGlobalVersion.ts

@@ -20,6 +20,7 @@ export async function createGlobalVersion<T extends TypeWithID>(
     returning,
     select,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     versionData,
   }: CreateGlobalVersionArgs,
@@ -37,6 +38,7 @@ export async function createGlobalVersion<T extends TypeWithID>(
       latest: true,
       publishedLocale,
       snapshot,
+      unpublishedLocale,
       updatedAt,
       version: versionData,
     },

packages/drizzle/src/createVersion.ts

@@ -21,6 +21,7 @@ export async function createVersion<T extends TypeWithID>(
     returning,
     select,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     versionData,
   }: CreateVersionArgs<T>,
@@ -43,6 +44,7 @@ export async function createVersion<T extends TypeWithID>(
     parent,
     publishedLocale,
     snapshot,
+    unpublishedLocale,
     updatedAt,
     version,
   }

packages/next/src/views/Document/getVersions.ts

@@ -170,6 +170,15 @@ export const getVersions = async ({
                     equals: id,
                   },
                 },
+                ...(payload.config.localization
+                  ? [
+                      {
+                        snapshot: {
+                          not_equals: true,
+                        },
+                      },
+                    ]
+                  : []),
                 {
                   'version._status': {
                     equals: 'draft',
@@ -260,6 +269,15 @@ export const getVersions = async ({
                     equals: 'draft',
                   },
                 },
+                ...(payload.config.localization
+                  ? [
+                      {
+                        snapshot: {
+                          not_equals: true,
+                        },
+                      },
+                    ]
+                  : []),
                 {
                   updatedAt: {
                     greater_than: publishedDoc.updatedAt,

packages/next/src/views/Version/VersionPillLabel/VersionPillLabel.tsx

@@ -28,6 +28,7 @@ export const VersionPillLabel: React.FC<{
     [key: string]: unknown
     id: number | string
     publishedLocale?: string
+    unpublishedLocale?: string
     updatedAt?: string
     version: {
       [key: string]: unknown
@@ -85,15 +86,14 @@ export const VersionPillLabel: React.FC<{
     ? formatDate({ date: doc.updatedAt, i18n, pattern: dateFormat })
     : null
 
-  const localeCode = Array.isArray(doc.publishedLocale)
-    ? doc.publishedLocale[0]
-    : doc.publishedLocale
+  const getLocaleLabel = (input) => {
+    const code = Array.isArray(input) ? input[0] : input
+    const loc = localization && localization?.locales?.find((l) => l.code === code)
+    return loc?.label?.[i18n?.language] || loc?.label || null
+  }
 
-  const locale =
-    localization && localization?.locales
-      ? localization.locales.find((loc) => loc.code === localeCode)
-      : null
-  const localeLabel = locale ? locale?.label?.[i18n?.language] || locale?.label : null
+  const unpublishedLocaleLabel = getLocaleLabel(doc.unpublishedLocale)
+  const localeLabel = getLocaleLabel(doc.publishedLocale)
 
   return (
     <div className={baseClass}>
@@ -117,6 +117,11 @@ export const VersionPillLabel: React.FC<{
         </React.Fragment>
       )}
       {localeLabel && <Pill size="small">{localeLabel}</Pill>}
+      {unpublishedLocaleLabel && (
+        <Pill size="small">
+          {unpublishedLocaleLabel} {t('version:unpublished')}
+        </Pill>
+      )}
     </div>
   )
 }

packages/next/src/views/Versions/cells/AutosaveCell/index.tsx

@@ -20,6 +20,7 @@ type AutosaveCellProps = {
     autosave?: boolean
     id: number | string
     publishedLocale?: string
+    unpublishedLocale?: string
     version: {
       _status: string
     }

packages/payload/src/collections/endpoints/updateByID.ts

@@ -18,6 +18,7 @@ export const updateByIDHandler: PayloadHandler = async (req) => {
   const overrideLock = searchParams.get('overrideLock')
   const trash = searchParams.get('trash') === 'true'
   const publishSpecificLocale = req.query.publishSpecificLocale as string | undefined
+  const unpublishSpecificLocale = req.query.unpublishSpecificLocale as string | undefined
 
   const doc = await updateByIDOperation({
     id,
@@ -32,6 +33,7 @@ export const updateByIDHandler: PayloadHandler = async (req) => {
     req,
     select: sanitizeSelectParam(req.query.select),
     trash,
+    unpublishSpecificLocale,
   })
 
   let message = req.t('general:updatedSuccessfully')

packages/payload/src/collections/operations/local/update.ts

@@ -120,6 +120,10 @@ export type BaseOptions<TSlug extends CollectionSlug, TSelect extends SelectType
    * @default false
    */
   trash?: boolean
+  /**
+   * Unpublish the document / documents for a specific locale.
+   */
+  unpublishSpecificLocale?: string
   /**
    * If you set `overrideAccess` to `false`, you can pass a user to use against the access control checks.
    */
@@ -227,6 +231,7 @@ async function updateLocal<
     showHiddenFields,
     sort,
     trash = false,
+    unpublishSpecificLocale,
     where,
   } = options
 
@@ -261,6 +266,7 @@ async function updateLocal<
     showHiddenFields,
     sort,
     trash,
+    unpublishSpecificLocale,
     where,
   }
 

packages/payload/src/collections/operations/update.ts

@@ -56,6 +56,7 @@ export type Arguments<TSlug extends CollectionSlug> = {
    */
   sort?: Sort
   trash?: boolean
+  unpublishSpecificLocale?: string
   where: Where
 }
 
@@ -114,6 +115,7 @@ export const updateOperation = async <
       showHiddenFields,
       sort: incomingSort,
       trash = false,
+      unpublishSpecificLocale,
       where,
     } = args
 
@@ -261,6 +263,7 @@ export const updateOperation = async <
           req,
           select: select!,
           showHiddenFields: showHiddenFields!,
+          unpublishSpecificLocale,
         })
 
         return updatedDoc

packages/payload/src/collections/operations/updateByID.ts

@@ -49,6 +49,7 @@ export type Arguments<TSlug extends CollectionSlug> = {
   select?: SelectType
   showHiddenFields?: boolean
   trash?: boolean
+  unpublishSpecificLocale?: string
 }
 
 export const updateByIDOperation = async <
@@ -83,6 +84,10 @@ export const updateByIDOperation = async <
       args.req.locale = args.publishSpecificLocale
     }
 
+    if (args.unpublishSpecificLocale) {
+      args.req.locale = args.unpublishSpecificLocale
+    }
+
     const {
       id,
       autosave = false,
@@ -105,6 +110,7 @@ export const updateByIDOperation = async <
       select: incomingSelect,
       showHiddenFields,
       trash = false,
+      unpublishSpecificLocale,
     } = args
 
     if (!id) {
@@ -216,6 +222,7 @@ export const updateByIDOperation = async <
       req,
       select: select!,
       showHiddenFields: showHiddenFields!,
+      unpublishSpecificLocale,
     })
 
     await unlinkTempFiles({