Topic Template Placeholder Text 主题组件

主题模板占位符文本主题组件

此主题组件使您能够将主题模板显示为占位符(水印),而不是可编辑的模板文本。

这允许您为每个主题提供自定义说明作为占位符。

例如:

这是正常的占位符(水印)文本。

注意:您现在可以通过更改自定义文本来全局更改此设置。

前往 管理 > 自定义 > 文本

然后搜索您在屏幕上看到的文本。
搜索“BBCode”应该能帮您找到所需内容:

然后将 js.composer.reply_placeholder 的值更改为您想要显示的占位符文本

您也可以在每个类别中设置主题模板。

在“编辑类别”对话框中选择“主题模板”。您可以为类别添加自定义模板。

这效果很好,但用户必须删除模板文本后才能开始输入帖子。

此主题组件使您能够将主题模板文本显示为占位符(水印)文本,而不是可编辑文本。您只需点击文本框即可开始输入。

它可以设置为将所有主题模板显示为占位符,或者您可以通过在主题模板中添加 [placeholder] 指示符,按个案进行设置。

安装主题组件

:hammer_and_wrench: Git 仓库:https://github.com/naidihr/discourse-topic-template-placeholders

:thinking: 如何安装主题或主题组件?

致谢

感谢 @merefield 重构 JQuery 元素以使用 Ember 框架和 Discourse 核心。

请注意,更新后的版本仅测试在 Discourse 2.4.1 及以上版本中可用。如果您使用的是更早的 Discourse 版本,请尝试原始版本,该版本已在 2.3.10 版本中测试。
原始版本仓库:https://github.com/naidihr/discourse-topic-template-placeholders_original

35 个赞

PS development note. I had to do a JQuery hack to get this to work as a theme component. If it is possible to update the placeholder via the model - I would be grateful of you would let me know.

8 个赞

You can try something like this

<script type="text/discourse-plugin" version="0.8">
  api.modifyClass("model:composer", {
    applyTopicTemplate() {
      this._super(...arguments);

      Ember.run.schedule("afterRender", () => {
        // do your work here
      });
    }
  });
</script>

This should allow you to add some custom logic when Discourse applies category topic templates.

That said, this type of way of writing stuff is a bit outdated. I would also recommend that you give this a read if you plan to spend a lot time on Discourse themes. It makes life much easier.

9 个赞

Great idea for a Theme Component!

I’ve gone ahead and submitted a PR to do the following:

  • removes need for jQuery
  • removes need to worry about timing (use Ember framework & Discourse core, don’t fight them)
  • modifies the Composer Model to help achieve the result (as you rightly suggested)

I won’t be upset if you don’t merge it, but hope it helps to see another way of doing things :slight_smile:

(I can’t promise there are no bugs, but happy to follow up on any ! :cowboy_hat_face: )

9 个赞

Thanks Robert. I’ve merged that PR. Much appreciated :+1:

2 个赞

This is literally what I was looking for! You are a god! :bowing_man: :shallow_pan_of_food: :bowing_woman:
Please accept this humble emoji offering. :canned_food:

1 个赞

FYI this only works if you first go to the category and create a new topic. If you try to create a new topic from the latest page and then select a category from the dropdown the text doesn’t display.

2 个赞

That’s expected? That’s how Topic Template functionality normally works. The Topic Template won’t be considered in the latter case.

But yeah, imho, that could be improved in even vanilla Discourse without this TC to support your latter case. I have personally found it annoying that users are not presented with the Template if they go the second route.

This TC is just piggybacking off of core so …

Maybe we’re talking about different things, but this is how it works for me…

1 个赞

This might be due to some other reason because it works here on Meta. if you go to /latest, open the composer and then select the marketplace category you get the template we have for that.

4 个赞

Yep weird. Sorry I think it might have been resolved. This was nagging me for ages but seems to work now.

Ok that presents a new challenge. Haha.

4 个赞

Hi Robert - I tested it after the merge and it was working - but it no longer is for me? This is with the override setting - not using the [placeholder]. Please can you check with your build as well?

Also on my original version - it did work the same if you started a new Topic from the latest page and then select the category.

I may need to roll back…?

I’m looking at it now. Give me a little while.

OK PR for fix raised: FIX: change the placeholder & template when switching selected Category by merefield · Pull Request #2 · naidihr/discourse-topic-template-placeholders · GitHub

It is now taking the Category from the Composer selection. Now that’s done, it seems to work in all situations, but please confirm.

2 个赞

Hi Robert, I merged that last PR and updated to the latest theme component version in but it is still showing the template text for default by me, even though I have “display all topic templates as placeholders” set. I am on Discourse 2.4.1. Any more thoughts?

2 个赞

That works, but it also doesn’t work at all if display all topic templates as placeholders is turned on, even if I’m in the category. Regretting volunteering for this now? :stuck_out_tongue_winking_eye:

2 个赞

No problem guys. We just iterate. :). I’ll take a look.

Update: PR https://github.com/naidihr/discourse-topic-template-placeholders/pull/3

When checking out remember to refresh the page if you change a setting.

2 个赞

Great Robert. That last PR has fixed it. Also when starting a topic from the latest or category pages. All looking good now. Thank you for taking the time to look at this. Very neat solution _super job :wink::+1:

3 个赞

No problem. A pleasure. Sorry my initial testing should have been more thorough. Thanks for your patience.

I think we are on a good track right now, hopefully!

Keep coming up with more great ideas and putting them into practice!

3 个赞

Howdy folks! We love the idea of this theme component!

I just tried to install it on our discourse instance but I’m running into some trouble here.
It seems that when enabled on the theme, it breaks some of the styling already in the theme.
For example, the buttons at the user drop down:

become like this when enabled:


In addition to this, the placeholder doesn’t appear to work, both with 'Display all your Topic Templates as placeholders (watermark text)' enabled, and disabled.

It could be that our discourse instance is v2.3.10?

I’ve taken a look at the code here and can’t discern why our styling would be messy.

We rely on another team to manage and update our discourse instance & it’s a bit of a big task to get that done.

I’m hoping for a quick tip to potentially fix this, but, if it boils down to our discourse version that’s fine too!

Thanks in advance :smiley: