github
/
halo
mirror of https://github.com/halo-dev/halo
1
0
Fork 0
Code Issues Releases Wiki Activity

Merge pull request #6116 from guqing/feature/6093 

feat: support hide categories and posts from the list
pull/6082/head
John Niang 2024-06-26 19:33:47 +08:00 committed by GitHub
parent 68d428aa29 bc1033611e
commit 1a0e20b8ab
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
24 changed files with 318 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
api-docs/openapi/v3_0/aggregated.json
View File

@ -15506,6 +15506,9 @@
"minLength": 1,
"type": "string"
},
"hideFromList": {
"type": "boolean"
},
"postTemplate": {
"maxLength": 255,
"type": "string"
@ -19659,6 +19662,9 @@
"excerpt": {
"type": "string"
},
"hideFromList": {
"type": "boolean"
},
"inProgress": {
"type": "boolean"
},
@ -21468,6 +21474,9 @@
"excerpt": {
"type": "string"
},
"hideFromList": {
"type": "boolean"
},
"inProgress": {
"type": "boolean"
},

10
api/src/main/java/run/halo/app/core/extension/content/Category.java
View File

@ -27,6 +27,7 @@ import run.halo.app.extension.GroupVersionKind;
public class Category extends AbstractExtension {
public static final String KIND = "Category";
public static final String LAST_HIDDEN_STATE_ANNO = "content.halo.run/last-hidden-state";
public static final GroupVersionKind GVK = GroupVersionKind.fromExtension(Category.class);
@ -79,6 +80,15 @@ public class Category extends AbstractExtension {
* and B will be queried, but C and D will not be queried.</p>
*/
private boolean preventParentPostCascadeQuery;
/**
* <p>Whether to hide the category from the category list.</p>
* <p>When set to true, the category including its subcategories and related posts will
* not be displayed in the category list, but it can still be accessed by permalink.</p>
* <p>Limitation: It only takes effect on the theme-side categorized list and it only
* allows to be set to true on the first level(root node) of categories.</p>
*/
private boolean hideFromList;
}
@JsonIgnore

5
api/src/main/java/run/halo/app/core/extension/content/Post.java
View File

@ -168,6 +168,11 @@ public class Post extends AbstractExtension {
private List<String> contributors;
/**
* see {@link Category.CategorySpec#isHideFromList()}.
*/
private Boolean hideFromList;
private Instant lastModifyTime;
private Long observedVersion;

2
api/src/main/java/run/halo/app/extension/index/query/NotEqual.java
View File

@ -21,7 +21,7 @@ public class NotEqual extends SimpleQuery {
indexView.acquireReadLock();
try {
NavigableSet<String> equalNames = equalQuery.matches(indexView);
NavigableSet<String> allNames = indexView.getIdsForField(fieldName);
NavigableSet<String> allNames = indexView.getAllIds();
allNames.removeAll(equalNames);
return allNames;
} finally {

6
application/src/main/java/run/halo/app/content/AbstractEventReconciler.java
View File

@ -3,7 +3,6 @@ package run.halo.app.content;
import java.time.Duration;
import java.time.Instant;
import org.springframework.context.SmartLifecycle;
import run.halo.app.extension.ExtensionClient;
import run.halo.app.extension.controller.Controller;
import run.halo.app.extension.controller.ControllerBuilder;
import run.halo.app.extension.controller.DefaultController;
@ -24,12 +23,9 @@ public abstract class AbstractEventReconciler<E> implements Reconciler<E>, Smart
protected volatile boolean running = false;
protected final ExtensionClient client;
private final String controllerName;
protected AbstractEventReconciler(String controllerName, ExtensionClient client) {
this.client = client;
protected AbstractEventReconciler(String controllerName) {
this.controllerName = controllerName;
this.queue = new DefaultQueue<>(Instant::now);
this.controller = this.setupWith(null);

4
application/src/main/java/run/halo/app/content/CategoryPostCountUpdater.java
View File

@ -37,10 +37,12 @@ import run.halo.app.infra.utils.JsonUtils;
public class CategoryPostCountUpdater
extends AbstractEventReconciler<CategoryPostCountUpdater.PostRelatedCategories> {
protected final ExtensionClient client;
private final CategoryPostCountService categoryPostCountService;
public CategoryPostCountUpdater(ExtensionClient client) {
super(CategoryPostCountUpdater.class.getName(), client);
super(CategoryPostCountUpdater.class.getName());
this.client = client;
this.categoryPostCountService = new CategoryPostCountService(client);
}

5
application/src/main/java/run/halo/app/content/CategoryService.java
View File

@ -2,9 +2,14 @@ package run.halo.app.content;
import org.springframework.lang.NonNull;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;
import run.halo.app.core.extension.content.Category;
public interface CategoryService {
Flux<Category> listChildren(@NonNull String categoryName);
Mono<Category> getParentByName(@NonNull String categoryName);
Mono<Boolean> isCategoryHidden(@NonNull String categoryName);
}

55
application/src/main/java/run/halo/app/content/PostHideFromListStateUpdater.java Normal file
View File

@ -0,0 +1,55 @@
package run.halo.app.content;
import static run.halo.app.extension.index.query.QueryFactory.equal;
import org.springframework.context.event.EventListener;
import org.springframework.lang.NonNull;
import org.springframework.stereotype.Component;
import run.halo.app.core.extension.content.Post;
import run.halo.app.event.post.CategoryHiddenStateChangeEvent;
import run.halo.app.extension.ListOptions;
import run.halo.app.extension.ReactiveExtensionClient;
import run.halo.app.extension.router.selector.FieldSelector;
import run.halo.app.infra.ReactiveExtensionPaginatedOperator;
/**
* Synchronize the {@link Post.PostStatus#getHideFromList()} state of the post with the category.
*
* @author guqing
* @since 2.17.0
*/
@Component
public class PostHideFromListStateUpdater
extends AbstractEventReconciler<CategoryHiddenStateChangeEvent> {
private final ReactiveExtensionPaginatedOperator reactiveExtensionPaginatedOperator;
private final ReactiveExtensionClient client;
protected PostHideFromListStateUpdater(ReactiveExtensionClient client,
ReactiveExtensionPaginatedOperator reactiveExtensionPaginatedOperator) {
super(PostHideFromListStateUpdater.class.getName());
this.reactiveExtensionPaginatedOperator = reactiveExtensionPaginatedOperator;
this.client = client;
}
@Override
public Result reconcile(CategoryHiddenStateChangeEvent request) {
var listOptions = new ListOptions();
listOptions.setFieldSelector(FieldSelector.of(
equal("spec.categories", request.getCategoryName())
));
reactiveExtensionPaginatedOperator.list(Post.class, listOptions)
.flatMap(post -> {
post.getStatusOrDefault().setHideFromList(request.isHidden());
return client.update(post);
})
.then()
.block();
return Result.doNotRetry();
}
@EventListener(CategoryHiddenStateChangeEvent.class)
public void onApplicationEvent(@NonNull CategoryHiddenStateChangeEvent event) {
this.queue.addImmediately(event);
}
}

4
application/src/main/java/run/halo/app/content/TagPostCountUpdater.java
View File

@ -35,9 +35,11 @@ import run.halo.app.infra.utils.JsonUtils;
@Component
public class TagPostCountUpdater
extends AbstractEventReconciler<TagPostCountUpdater.PostRelatedTags> {
private final ExtensionClient client;
public TagPostCountUpdater(ExtensionClient client) {
super(TagPostCountUpdater.class.getName(), client);
super(TagPostCountUpdater.class.getName());
this.client = client;
}
@Override

37
application/src/main/java/run/halo/app/content/impl/CategoryServiceImpl.java
View File

@ -1,13 +1,21 @@
package run.halo.app.content.impl;
import static run.halo.app.extension.index.query.QueryFactory.equal;
import lombok.RequiredArgsConstructor;
import org.apache.commons.lang3.StringUtils;
import org.springframework.data.domain.Sort;
import org.springframework.lang.NonNull;
import org.springframework.stereotype.Component;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;
import run.halo.app.content.CategoryService;
import run.halo.app.core.extension.content.Category;
import run.halo.app.extension.ListOptions;
import run.halo.app.extension.ListResult;
import run.halo.app.extension.PageRequestImpl;
import run.halo.app.extension.ReactiveExtensionClient;
import run.halo.app.extension.router.selector.FieldSelector;
@Component
@RequiredArgsConstructor
@ -28,6 +36,35 @@ public class CategoryServiceImpl implements CategoryService {
});
}
@Override
public Mono<Category> getParentByName(@NonNull String name) {
if (StringUtils.isBlank(name)) {
return Mono.empty();
}
var listOptions = new ListOptions();
listOptions.setFieldSelector(FieldSelector.of(
equal("spec.children", name)
));
return client.listBy(Category.class, listOptions,
PageRequestImpl.of(1, 1, defaultSort())
)
.flatMap(result -> Mono.justOrEmpty(ListResult.first(result)));
}
@Override
public Mono<Boolean> isCategoryHidden(@NonNull String categoryName) {
return client.fetch(Category.class, categoryName)
.expand(category -> getParentByName(category.getMetadata().getName()))
.filter(category -> category.getSpec().isHideFromList())
.hasElements();
}
static Sort defaultSort() {
return Sort.by(Sort.Order.desc("spec.priority"),
Sort.Order.desc("metadata.creationTimestamp"),
Sort.Order.desc("metadata.name"));
}
private boolean isNotIndependent(Category category) {
return !category.getSpec().isPreventParentPostCascadeQuery();
}

50
application/src/main/java/run/halo/app/core/extension/reconciler/CategoryReconciler.java
View File

@ -2,17 +2,21 @@ package run.halo.app.core.extension.reconciler;
import static run.halo.app.extension.ExtensionUtil.addFinalizers;
import static run.halo.app.extension.ExtensionUtil.removeFinalizers;
import static run.halo.app.extension.MetadataUtil.nullSafeAnnotations;
import java.util.Map;
import java.util.Set;
import lombok.AllArgsConstructor;
import org.springframework.context.ApplicationEventPublisher;
import org.springframework.stereotype.Component;
import org.springframework.util.CollectionUtils;
import run.halo.app.content.CategoryService;
import run.halo.app.content.permalinks.CategoryPermalinkPolicy;
import run.halo.app.core.extension.content.Category;
import run.halo.app.core.extension.content.Constant;
import run.halo.app.event.post.CategoryHiddenStateChangeEvent;
import run.halo.app.extension.ExtensionClient;
import run.halo.app.extension.ExtensionUtil;
import run.halo.app.extension.MetadataUtil;
import run.halo.app.extension.controller.Controller;
import run.halo.app.extension.controller.ControllerBuilder;
import run.halo.app.extension.controller.Reconciler;
@ -29,6 +33,8 @@ public class CategoryReconciler implements Reconciler<Reconciler.Request> {
static final String FINALIZER_NAME = "category-protection";
private final ExtensionClient client;
private final CategoryPermalinkPolicy categoryPermalinkPolicy;
private final CategoryService categoryService;
private final ApplicationEventPublisher eventPublisher;
@Override
public Result reconcile(Request request) {
@ -44,12 +50,52 @@ public class CategoryReconciler implements Reconciler<Reconciler.Request> {
populatePermalinkPattern(category);
populatePermalink(category);
checkHideFromListState(category);
client.update(category);
});
return Result.doNotRetry();
}
/**
* TODO move this logic to before-create/update hook in the future see {@code gh-4343}.
*/
private void checkHideFromListState(Category category) {
final boolean hidden = categoryService.isCategoryHidden(category.getMetadata().getName())
.blockOptional()
.orElse(false);
category.getSpec().setHideFromList(hidden);
if (isHiddenStateChanged(category)) {
publishHiddenStateChangeEvent(category);
}
var children = category.getSpec().getChildren();
if (CollectionUtils.isEmpty(children)) {
return;
}
for (String childName : children) {
client.fetch(Category.class, childName)
.ifPresent(child -> {
child.getSpec().setHideFromList(hidden);
if (isHiddenStateChanged(child)) {
publishHiddenStateChangeEvent(child);
}
client.update(child);
});
}
}
private void publishHiddenStateChangeEvent(Category category) {
var hidden = category.getSpec().isHideFromList();
nullSafeAnnotations(category).put(Category.LAST_HIDDEN_STATE_ANNO, String.valueOf(hidden));
eventPublisher.publishEvent(new CategoryHiddenStateChangeEvent(this,
category.getMetadata().getName(), hidden));
}
boolean isHiddenStateChanged(Category category) {
var lastHiddenState = nullSafeAnnotations(category).get(Category.LAST_HIDDEN_STATE_ANNO);
return !String.valueOf(category.getSpec().isHideFromList()).equals(lastHiddenState);
}
@Override
public Controller setupWith(ControllerBuilder builder) {
return builder
@ -58,7 +104,7 @@ public class CategoryReconciler implements Reconciler<Reconciler.Request> {
}
void populatePermalinkPattern(Category category) {
Map<String, String> annotations = MetadataUtil.nullSafeAnnotations(category);
Map<String, String> annotations = nullSafeAnnotations(category);
String newPattern = categoryPermalinkPolicy.pattern();
annotations.put(Constant.PERMALINK_PATTERN_ANNO, newPattern);
}

24
application/src/main/java/run/halo/app/event/post/CategoryHiddenStateChangeEvent.java Normal file
View File

@ -0,0 +1,24 @@
package run.halo.app.event.post;
import lombok.Getter;
import org.springframework.context.ApplicationEvent;
import run.halo.app.core.extension.content.Category;
/**
* When the category {@link Category.CategorySpec#isHideFromList()} state changes, this event is
* triggered.
*
* @author guqing
* @since 2.17.0
*/
@Getter
public class CategoryHiddenStateChangeEvent extends ApplicationEvent {
private final String categoryName;
private final boolean hidden;
public CategoryHiddenStateChangeEvent(Object source, String categoryName, boolean hidden) {
super(source);
this.categoryName = categoryName;
this.hidden = hidden;
}
}

21
application/src/main/java/run/halo/app/infra/SchemeInitializer.java
View File

@ -192,6 +192,14 @@ public class SchemeInitializer implements ApplicationListener<ApplicationContext
var lastModifyTime = post.getStatus().getLastModifyTime();
return lastModifyTime == null ? null : lastModifyTime.toString();
})));
indexSpecs.add(new IndexSpec()
.setName("status.hideFromList")
.setIndexFunc(simpleAttribute(Post.class, post -> {
var hidden = post.getStatus().getHideFromList();
// only index when hidden is true
return (hidden == null || !hidden) ? null : BooleanUtils.TRUE;
}))
);
indexSpecs.add(new IndexSpec()
.setName(Post.REQUIRE_SYNC_ON_STARTUP_INDEX_NAME)
.setIndexFunc(simpleAttribute(Post.class, post -> {
@ -238,6 +246,19 @@ public class SchemeInitializer implements ApplicationListener<ApplicationContext
.setName("spec.priority")
.setIndexFunc(simpleAttribute(Category.class,
category -> defaultIfNull(category.getSpec().getPriority(), 0).toString())));
indexSpecs.add(new IndexSpec()
.setName("spec.children")
.setIndexFunc(multiValueAttribute(Category.class, category -> {
var children = category.getSpec().getChildren();
return children == null ? Set.of() : Set.copyOf(children);
}))
);
indexSpecs.add(new IndexSpec()
.setName("spec.hideFromList")
.setIndexFunc(simpleAttribute(Category.class,
category -> toStringTrueFalse(isTrue(category.getSpec().isHideFromList()))
))
);
});
schemeManager.register(Tag.class, indexSpecs -> {
indexSpecs.add(new IndexSpec()

33
application/src/main/java/run/halo/app/theme/finders/impl/CategoryFinderImpl.java
View File

@ -1,5 +1,7 @@
package run.halo.app.theme.finders.impl;
import static run.halo.app.extension.index.query.QueryFactory.notEqual;
import java.time.Instant;
import java.util.Collection;
import java.util.Comparator;
@ -8,19 +10,21 @@ import java.util.Map;
import java.util.Objects;
import java.util.function.Function;
import java.util.stream.Collectors;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.BooleanUtils;
import org.apache.commons.lang3.ObjectUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.data.domain.Sort;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;
import run.halo.app.content.CategoryService;
import run.halo.app.core.extension.content.Category;
import run.halo.app.extension.ListOptions;
import run.halo.app.extension.ListResult;
import run.halo.app.extension.Metadata;
import run.halo.app.extension.PageRequestImpl;
import run.halo.app.extension.ReactiveExtensionClient;
import run.halo.app.extension.index.query.QueryFactory;
import run.halo.app.extension.router.selector.FieldSelector;
import run.halo.app.theme.finders.CategoryFinder;
import run.halo.app.theme.finders.Finder;
@ -35,12 +39,10 @@ import run.halo.app.theme.finders.vo.CategoryVo;
*/
@Slf4j
@Finder("categoryFinder")
@RequiredArgsConstructor
public class CategoryFinderImpl implements CategoryFinder {
private final ReactiveExtensionClient client;
public CategoryFinderImpl(ReactiveExtensionClient client) {
this.client = client;
}
private final CategoryService categoryService;
@Override
public Mono<CategoryVo> getByName(String name) {
@ -65,7 +67,11 @@ public class CategoryFinderImpl implements CategoryFinder {
@Override
public Mono<ListResult<CategoryVo>> list(Integer page, Integer size) {
return client.listBy(Category.class, new ListOptions(),
var listOptions = new ListOptions();
listOptions.setFieldSelector(FieldSelector.of(
notEqual("spec.hideFromList", BooleanUtils.TRUE)
));
return client.listBy(Category.class, listOptions,
PageRequestImpl.of(pageNullSafe(page), sizeNullSafe(size), defaultSort())
)
.map(list -> {
@ -91,6 +97,7 @@ public class CategoryFinderImpl implements CategoryFinder {
@Override
public Flux<CategoryVo> listAll() {
return client.listAll(Category.class, new ListOptions(), defaultSort())
.filter(category -> !category.getSpec().isHideFromList())
.map(CategoryVo::from);
}
@ -203,18 +210,8 @@ public class CategoryFinderImpl implements CategoryFinder {
@Override
public Mono<CategoryVo> getParentByName(String name) {
if (StringUtils.isBlank(name)) {
return Mono.empty();
}
var listOptions = new ListOptions();
listOptions.setFieldSelector(FieldSelector.of(
QueryFactory.equal("spec.children", name)
));
return client.listBy(Category.class, listOptions,
PageRequestImpl.of(1, 1, defaultSort())
)
.map(ListResult::first)
.mapNotNull(item -> item.map(CategoryVo::from).orElse(null));
return categoryService.getParentByName(name)
.map(CategoryVo::from);
}
int pageNullSafe(Integer page) {

10
application/src/main/java/run/halo/app/theme/finders/impl/PostFinderImpl.java
View File

@ -3,12 +3,14 @@ package run.halo.app.theme.finders.impl;
import static run.halo.app.extension.index.query.QueryFactory.and;
import static run.halo.app.extension.index.query.QueryFactory.equal;
import static run.halo.app.extension.index.query.QueryFactory.in;
import static run.halo.app.extension.index.query.QueryFactory.notEqual;
import java.util.Comparator;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
import lombok.AllArgsConstructor;
import org.apache.commons.lang3.BooleanUtils;
import org.apache.commons.lang3.ObjectUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.data.domain.Sort;
@ -136,7 +138,10 @@ public class PostFinderImpl implements PostFinder {
@Override
public Mono<ListResult<ListedPostVo>> list(Integer page, Integer size) {
return postPublicQueryService.list(new ListOptions(), getPageRequest(page, size));
var listOptions = ListOptions.builder()
.fieldQuery(notEqual("status.hideFromList", BooleanUtils.TRUE))
.build();
return postPublicQueryService.list(listOptions, getPageRequest(page, size));
}
private PageRequestImpl getPageRequest(Integer page, Integer size) {
@ -202,6 +207,9 @@ public class PostFinderImpl implements PostFinder {
public Mono<ListResult<PostArchiveVo>> archives(Integer page, Integer size, String year,
String month) {
var listOptions = new ListOptions();
listOptions.setFieldSelector(FieldSelector.of(
notEqual("status.hideFromList", BooleanUtils.TRUE))
);
var labelSelectorBuilder = LabelSelector.builder();
if (StringUtils.isNotBlank(year)) {
labelSelectorBuilder.eq(Post.ARCHIVE_YEAR_LABEL, year);

9
application/src/test/java/run/halo/app/theme/finders/impl/CategoryFinderImplTest.java
View File

@ -24,6 +24,7 @@ import org.springframework.data.domain.Sort;
import org.springframework.util.ResourceUtils;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;
import run.halo.app.content.CategoryService;
import run.halo.app.core.extension.content.Category;
import run.halo.app.extension.ListOptions;
import run.halo.app.extension.ListResult;
@ -46,11 +47,14 @@ class CategoryFinderImplTest {
@Mock
private ReactiveExtensionClient client;
@Mock
private CategoryService categoryService;
private CategoryFinderImpl categoryFinder;
@BeforeEach
void setUp() {
categoryFinder = new CategoryFinderImpl(client);
categoryFinder = new CategoryFinderImpl(client, categoryService);
}
@Test
@ -78,7 +82,8 @@ class CategoryFinderImplTest {
"C1",
"C2"
],
"preventParentPostCascadeQuery": false
"preventParentPostCascadeQuery": false,
"hideFromList": false
}
}
""",

18
ui/console-src/modules/contents/posts/categories/components/CategoryEditingModal.vue
View File

@ -26,10 +26,12 @@ const props = withDefaults(
defineProps<{
category?: Category;
parentCategory?: Category;
isChildLevelCategory: boolean;
}>(),
{
category: undefined,
parentCategory: undefined,
isChildLevelCategory: false,
}
);
@ -266,6 +268,22 @@ const { handleGenerateSlug } = useSlugify(
:accepts="['image/*']"
validation="length:0,1024"
></FormKit>
<FormKit
v-model="formState.spec.hideFromList"
:disabled="isChildLevelCategory"
:label="
$t(
'core.post_category.editing_modal.fields.hide_from_list.label'
)
"
:help="
$t(
'core.post_category.editing_modal.fields.hide_from_list.help'
)
"
type="checkbox"
name="hideFromList"
></FormKit>
<FormKit
v-model="formState.spec.preventParentPostCascadeQuery"
:label="

13
ui/console-src/modules/contents/posts/categories/components/CategoryListItem.vue
View File

@ -5,6 +5,7 @@ import type { Category } from "@halo-dev/api-client";
import { coreApiClient } from "@halo-dev/api-client";
import {
Dialog,
IconEyeOff,
IconList,
Toast,
VDropdownItem,
@ -23,6 +24,8 @@ import CategoryEditingModal from "./CategoryEditingModal.vue";
const { currentUserHasPermission } = usePermission();
withDefaults(defineProps<{ isChildLevel?: boolean }>(), {});
const categories = defineModel({
type: Array as PropType<CategoryTree[]>,
default: [],
@ -95,6 +98,7 @@ const handleDelete = async (category: CategoryTree) => {
>
<CategoryEditingModal
v-if="editingModal"
:is-child-level-category="isChildLevel"
:category="selectedCategory"
:parent-category="selectedParentCategory"
@close="onEditingModalClose"
@ -134,6 +138,14 @@ const handleDelete = async (category: CategoryTree) => {
/>
</template>
</VEntityField>
<VEntityField v-if="category.spec.hideFromList">
<template #description>
<IconEyeOff
v-tooltip="$t('core.post_category.list.fields.hide_from_list')"
class="cursor-pointer text-sm transition-all hover:text-blue-600"
/>
</template>
</VEntityField>
<VEntityField v-if="category.spec.preventParentPostCascadeQuery">
<template #description>
<GridiconsLinkBreak
@ -185,6 +197,7 @@ const handleDelete = async (category: CategoryTree) => {
</VEntity>
<CategoryListItem
v-model="category.spec.children"
is-child-level
class="pl-10 transition-all duration-300"
@change="onChange"
/>

6
ui/packages/api-client/src/models/category-spec.ts
View File

@ -44,6 +44,12 @@ export interface CategorySpec {
* @memberof CategorySpec
*/
'displayName': string;
/**
*
* @type {boolean}
* @memberof CategorySpec
*/
'hideFromList'?: boolean;
/**
*
* @type {string}

6
ui/packages/api-client/src/models/post-status.ts
View File

@ -47,6 +47,12 @@ export interface PostStatus {
* @memberof PostStatus
*/
'excerpt'?: string;
/**
*
* @type {boolean}
* @memberof PostStatus
*/
'hideFromList'?: boolean;
/**
*
* @type {boolean}

6
ui/packages/api-client/src/models/single-page-status.ts
View File

@ -47,6 +47,12 @@ export interface SinglePageStatus {
* @memberof SinglePageStatus
*/
'excerpt'?: string;
/**
*
* @type {boolean}
* @memberof SinglePageStatus
*/
'hideFromList'?: boolean;
/**
*
* @type {boolean}

8
ui/src/locales/en.yaml
View File

@ -416,11 +416,19 @@ core:
help: >-
Customize the rendering template of posts in the current category,
which requires support from the theme
hide_from_list:
label: Hide from list
help: >-
After turning on this option, this category and its subcategories,
as well as its posts, will not be displayed in the front-end list.
You need to actively visit the category archive page. This feature
is only effective for the first-level directory.
list:
fields:
prevent_parent_post_cascade_query: >-
Prevent parent category from including this category and its
subcategories in cascade post queries
hide_from_list: This category is hidden, This category and its subcategories, as well as its posts, will not be displayed in the front-end list. You need to actively visit the category archive page
page:
title: Pages
actions:

4
ui/src/locales/zh-CN.yaml
View File

@ -406,9 +406,13 @@ core:
post_template:
label: 自定义文章模板
help: 自定义当前分类下文章的渲染模版，需要主题提供支持
hide_from_list:
label: 在列表中隐藏
help: 开启此选项后，此分类和其下子分类，以及其下文章将不会显示在前台的列表中，需要主动访问分类归档页面，此功能仅对第一级目录生效
list:
fields:
prevent_parent_post_cascade_query: 阻止父级分类在级联文章查询中包含此分类及其子分类
hide_from_list: 已隐藏，此分类和其下子分类，以及其下文章将不会显示在前台的列表中
page:
title: 页面
actions:

4
ui/src/locales/zh-TW.yaml
View File

@ -386,9 +386,13 @@ core:
post_template:
label: 自定義文章模板
help: 自定義當前分類下文章的渲染模板，需要主題提供支持
hide_from_list:
label: 在列表中隱藏
help: 開啟此選項後，此分類和其下子分類，以及其下文章將不會顯示在前臺的列表中，需要主動訪問分類歸檔頁面，此功能僅對第一級目錄生效
list:
fields:
prevent_parent_post_cascade_query: 阻止父級分類在級聯文章查詢中包含此分類及其子分類
hide_from_list: 已隱藏，此分類和其下子分類，以及其下文章將不會顯示在前臺的列表中，需要主動訪問分類歸檔頁面
page:
title: 頁面
actions: