How do you guys build such amazing plugins with discourse ? I am not even able to integrate a custom field to discourse topic using a custom plugin. Is there any documentation that can help me build an advanced plugin like this? The introduction series to Discourse plugins only touches the plugin outlet part. But how do I take that and integrate it with Discourse? I tried reading the source code of Discourse plugins, as Jeff suggested, But I only have questions like what does add_to_serializer or create_custom_field do ? I also want to build amazing plugins / contribute to discourse… please let me know if you have any material on learning to create Discourse plugins.

The code is the only thing to look at. Everything used by the plugins is defined in Discourse core… or by Rails, or by Ruby itself. It’s open source all the way down, so if you don’t know what add_to_serializer does, search the Discourse codebase for def add_to_serializer, and the learnings shall continue.

And how do you debug the discourse application? I am using byebug, but I was looking more into a debugger which can be easily integrated with the text editor like atom or brackets or visual studio code.

Did you read this guide yet? [图片] Learn how to start building stuff for Discourse if you're newbie (like myself) Developers There are a few ‘how to start’ guides for working with Discourse already and a wealth of useful info on meta, but I thought it might help to give an insight to the mental processes of starting from little, if any, prior coding experience to building substantial Discourse plugins. Discourse is written by experienced developers and has a large codebase. This can feel intimidating. This intimidation factor can be a significant barrier for novice developers. This is a kind of ‘psychological primer’…

What you want is exactly what I want. I am completely lost as well. I was going to try a work around, but it seems that a plugin is the right way to do this. As there is no documentation, I will have to break the code to figure it out.

Between the “How to start building stuff…” guide and the “Beginner’s guide to creating Discourse plugins”, what exactly are you missing? If you can give us more specific feedback on what you need to get started, we’ll definitely take that into consideration.

For the JavaScript side of things, you want the plugin api [图片] A versioned API for client side plugins Development Later today I am going to be merging our new post rendering engine into master. Swapping out Ember/HTMLBars for a virtual-dom based renderer provides us with a huge performance increase, but it also has the side effect of being incompatible with how plugins were previously made. While doing this work, it occurred to me that we made a fairly big mistake in the past by not providing a mechanism for versioning the public APIs used by client side code. We used to encourage people to just dump in w… The source code is well documented https://github.com/discourse/discourse/blob/master/app/assets/javascripts/discourse/lib/plugin-api.js.es6 It took me a while to find it - maybe a link to the API topic could be added to the JavaScript section of the “Beginners guide to creating discourse plugins” @eviltrout

It seems like you’re asking for the conceptual viewpoint of how to build a plugin over the technical. I can’t say that I see myself as a great example of how to do it the right way, but here’s what I would suggest: Go through @eviltrout’s guide to building plugins and do every step. No skipping. This will give you a foundation of how to get started with a plugin and teach the core processes that you’ll need later. Pay attention to how things are done in core. What elements are used repeatedly? How do they use buttons, navigation, links, etc…? This will pay huge dividends later when you have an idea and want to know how to do it. Which brings me to 3. Learn how to trace code. When you see an element or want to use something from core (like the methods used to create new color themes in Customize), you need to know how to search the repository for the handlebars template that generates the html and trace it all the way back to the Rails routes or vice versa. If you can nail down every file and piece of code that is run to generate the front-end, you’re set up to duplicate a LOT without needing to write it all from scratch. Develop ninja skills when searching on GitHub. Knowing how to search for a code snippet within a given path in the repo or searching across repos within an organization are huge for me. Get really good with developer tools. It’s rare that I have an issue with code that I can’t decipher with the Chrome developer tools. Add the Ember Inspector extension to Chrome and pull up Meta. Open the composer, navigate to profiles, do stuff. And pay attention to how things move and change as you interact with the application. Pro tip: The network tab will give you tons of clues about how to pass data back and forth between Ruby and Ember. Read the code for other plugins. We’re all learning new ways to build plugins as we go. Cruise through the code of your favorite plugins and see how they’re doing things. This will help you translate the core code into plugin code. Just keep building. The more you try to build, the more you’ll learn how to build, and the better at building them you’ll become. We all start somewhere and we’re all still growing. Build something and share it. Don’t be afraid to ask. Sometimes it’s intimidating to post a question to something you feel is obvious. Do some searches and if you can’t find the answer, post it. Tell us what you’ve tried and where you’re stuck. We’re all problem-solving together. That’s what I’ve got. I hope that’s along the lines you were looking for. If not, let me know. I’d love to help others get going with Discourse plugins. There’s a lot of power in being able to customize and tweak your own site via custom code.

[图片] erlend_sh: If you can give us more specific feedback on what you need to get started, we’ll definitely take that into consideration. Some feedback from a new user: The lack of documentation in some places has been the most frustrating part of using Discourse so far. If there were a way for the community to contribute to a simple documentation site (like sphinx/readthedocs), I’d help write some of documentation as I figure things out. The documentation could be updated to point to the most relevant and current forum threads here for those tasks. It would be useful to have one canonical entry point for learning how to build more complex plugins (not just “hello world”). A list of where to start looking for answers to common tasks would be useful. The sidebar for the API docs is a good example. At the moment, information is scattered over many different forum posts, and it’s difficult to find. Asking people who are new to Ruby, Rails, and Ember to “just read the code” creates a significant barrier to entry for many. Example: I want to override the log out functionality on Discourse (to add a POST request to another URL on-logout) but don’t know where to look. I searched Github for Ruby files that handle log out and only found this, and it isn’t clear how I would override the functionality there. I’m too new to Ruby, Rails, and Ember to understand how it’s all wired together, so something that would only take a few hours with documentation ends up taking up days of time. It’s not just reading the information that takes time – it’s mostly figuring where to even find it among years of scattered forum posts for various different versions and configurations of the software.

[图片] j127: I want to override the log out functionality on Discourse (to add a POST request to another URL on-logout) but don’t know where to look Isn’t this already covered by the built in webhooks, in Admin, API, webhooks? We should have an on-user-logout webhook built in if we don’t already cc @tgxworld

Thanks, I didn’t see one for user logout, but that would be useful.

How do you learn to build Discourse plugins?

Development

erlend_sh (Erlend Sogge Heggen) 2017 年2 月 25 日 16:14 4

Did you read this guide yet?

话题		回复	浏览量
Learn how to start building stuff for Discourse if you're newbie (like myself) Developers explanation	14	30635	2023 年10 月 15 日
Plugin API documentations? Development	8	6935	2024 年3 月 31 日
Is there any online course to learn Discourse development Product Support	3	1817	2018 年7 月 15 日
[PAID] Mentorship needed Marketplace	7	1839	2019 年12 月 16 日
Developing Discourse Plugins - Part 1 - Create a basic plugin Developer Guides plugin-guides , tutorial	32	85657	2025 年7 月 8 日

How do you learn to build Discourse plugins?

相关话题