What is this code add_to_serializer in all these plugins

Разработка
1

I have seen this code in discourse_signatures plugin

User.register_custom_field_type('see_signatures', :boolean)
User.register_custom_field_type('signature_url', :text)
User.register_custom_field_type('signature_raw', :text)

if SiteSetting.signatures_enabled then
  add_to_serializer(:post, :user_signature, false) {
    if SiteSetting.signatures_advanced_mode then
      object.user.custom_fields['signature_raw']
    else
      object.user.custom_fields['signature_url']
    end
  }

  # I guess this should be the default @ discourse. PR maybe?
  add_to_serializer(:user, :custom_fields, false) {
    if object.custom_fields == nil then
      {}
    else
      object.custom_fields
    end
  }
end

In discourse national flags plugin

User.register_custom_field_type('nationalflag_iso', :text)

if SiteSetting.nationalflag_enabled then
  byebug;
  add_to_serializer(:post, :user_signature, false) {
    object.user.custom_fields['nationalflag_iso']
  }
  byebug;
  # I guess this should be the default @ discourse. PR maybe?
  add_to_serializer(:user, :custom_fields, false) {
    if object.custom_fields == nil then
      {}
    else
      object.custom_fields
    end
  }
end

I am not able to understand what is add_to_serializer is doing.

I checked in def add_to_serializer

def add_to_serializer(serializer, attr, define_include_method=true, &block)
  klass = "#{serializer.to_s.classify}Serializer".constantize rescue "#{serializer.to_s}Serializer".constantize

  klass.attributes(attr) unless attr.to_s.start_with?("include_")

  klass.send(:define_method, attr, &block)

  return unless define_include_method

  # Don't include serialized methods if the plugin is disabled
  plugin = self
  klass.send(:define_method, "include_#{attr}?") { plugin.enabled? }
end

I understand that User.register_custom_field_type('signature_raw', :text) will register a custom field type to User object. But what is add_to_serializer doing? I am not able to understand, can you explain me in plain english?

2

It’s essentially adding to the information that Discourse serializes out when sending that model to the client. For example, you may see a request to this endpoint when loading up a topic page:

http://meta.discourse.org/t/2349082394.json

which returns some payload like this:

{
  title: "Some topic title",
  archetype: 'regular',
  category_id: 7,
  post_stream: { posts: [...] },
  posts_count: 15,
  (etc etc.. lots more info about the topic in question)
}

Which is the json representation of a Discourse topic.

If I want to know more about the topic because of additional ‘stuff’ I do in my plugin, I can put in a line like

add_to_serializer :topic, :flag_name do
  object.flag_name # <- NB that 'object' here is the topic being serialized
end

(Also, by default, this method simply sends the specified message to ‘object’, meaning that

add_to_serializer :topic, :flag_name

is the same as

add_to_serializer :topic, :flag_name do
  object.flag_name
end

)

Once I’ve added the method to the serializer, I can end up with JSON output which includes that additional info

{
  title: "Some topic title",
  archetype: 'regular',
  category_id: 7,
  post_stream: { posts: [...] },
  posts_count: 15,
  flag_name: "some flag name"
  ...
}

Also note that you could achieve the same thing by overwriting the TopicSerializer class (which is exactly what the code snippet you’ve provided is doing)

# plugin.rb
TopicSerializer.class_eval do
  attributes :flag_name
  def flag_name
    object.flag_name
  end
end
4

Hi,
When running the following code,

TopicSerializer.class_eval do
  attributes :flag_name
  def flag_name
    object.flag_name
  end
end

I was getting the error “block in activate!’: uninitialized constant TopicSerializer (NameError)”. I think I have to “import” or “require” the TopicSerializer dependency. Can you please tell me what would be the dependency, as I am not able to figure it out.

5

Add this directly above your code require_dependency 'topic_serializer'

require_dependency 'topic_serializer'
class ::TopicSerializer
  attributes :flag_name
  def flag_name
    object.flag_name
  end
end
6

Hi thanks, but I got the error " `load’: No such file to load – topic_serializer (LoadError)". Does it pull from the app/serializers folder? I checked in that folder, I could find topic_list_serializer.rb, and many other related to topic, but couldnt find topic_serializer.rb

7

Right! Try TopicViewSerializer.

require_dependency 'topic_view_serializer'
class ::TopicViewSerializer
  attributes :flag_name
  def flag_name
    object.flag_name
  end
end
8

Привет! Я добавил пользовательское поле в форму редактирования категории.

При отправке формы я вижу в консоли JS, что эти поля отправляются следующим образом:
custom_fields[default_tag][]:good-feedback custom_fields[default_tag][]:one-more-tag

В основном файле плагина я делаю:

add_to_serializer(:basic_category, :default_tag){object.custom_fields[“default_tag”]}

Мои пользовательские поля не сохраняются в базу данных.

9

поможет ли теперь выполнение:

add_to_serializer(:basic_category, :default_tag, false ){object.custom_fields["default_tag"]}

?

11

Тогда я решил это, добавив функцию в событие :before_action, преобразовывая массив в строку с разделителями и обратно при извлечении.

Я не стал углубляться в то, почему массив нельзя хранить как пользовательское поле из коробки.

12

Так что это, возможно, упростит код?

13

Да, это сработало бы, если бы в данном случае это работало. Я попробую это через некоторое время и вернусь к вам с ответом.

14

Бедняжка, должно быть, тогда было больно :wink:

15

Это было воскресное вечером, и любопытство взяло верх. Было немного больно, но весело.
Это было то, что пытался сделать @pfaffman.

Нет боли — нет результата :wink:

16

ха-ха, так и есть! …

17

Привет, у меня та же проблема (custom_fields отправляются в консоли JS, но не сохраняются в БД). Я использовал способ add_to_serializer(:basic_category, :default_tag, false ){object.custom_fields["default_tag"]} в основном файле плагина.

Вы бы всё ещё рекомендовали это решение?

18

Здесь возникает много вопросов. Прежде всего, каких именно пользовательских полей?

19

Я работаю над плагином для автоматической синхронизации групп Discourse с LDAP. Я добавил пользовательское поле к модели Group (ldap_dn), чтобы сохранять в нём имя группы LDAP. Я пытаюсь получить значение этого пользовательского поля из поля ввода, которое добавил в плагин membership-plugin-outlet, и сохранить его в базу данных для последующего использования.

Для этого я добавил следующее в файл plugin.rb:

Group.register_custom_field_type(‘ldap_dn’, :text)
Group.preload_custom_fields << “ldap_dn” if
Group.respond_to? :preloaded_custom_fields

if SiteSetting.groups_sync_enabled then
add_to_serializer(:group_show, :custom_fields, false) {
object.custom_fields
}
end

Я новичок в Rails и Ember, поэтому не уверен, нужно ли мне выполнить ещё какие-то шаги, чтобы пользовательские поля сохранялись в БД, или в чём именно заключается проблема.

20

Я думаю, что если вы добавите
register_editable_group_custom_field 'field_name'
в ваш файл plugin.rb,

это должно решить проблему.

Примечание:
Serializer используется для отправки данных клиенту, а не для их получения.

21

Ах, понятно! Я новичок, так что это может быть очень глупый вопрос, но для получения данных я должен использовать API?

22

Моё решение даст зелёный свет вашему полю, когда данные придут на сервер. То есть речь идёт о получении данных.