-
Create an OAuth 2.0 Plugin
⏳️ AVAILABILITY: This feature is available only to Open Source developers and select Legacy Enterprise plan Vanilla Cloud developers. To learn how to create your own plugin, see: To learn about the OAuth2 addon that can provide a plug-and-play SSO solution, see: You can use the OAuth2 plugin as a template. Make sure your…
-
Branching and Pull Requests for Vanilla Cloud Self Development
This article is for Enterprise customers who have a self-development agreement with Vanilla Cloud. This article contains information regarding branch naming and pull requests so that your self-developed addons can be deployed to your site on Vanilla's cloud infrastructure. Localhost development You should do your self…
-
Adding and Editing Locale Translation Strings
Higher Logic Vanilla (Vanilla) is a fully localized application which means that all parts of our user interface have be able to be translated into "local languages." When developing, keep localization in mind. 📝 NOTE: This article details various things that you should consider when developing a localizable application.…
-
Install an Addon
In Higher Logic Vanilla (Vanilla), you can install addons by adding them to one of the following directories: /themes /plugins Install an addon by symlink Most addons have their source code managed in a virtual console system (VCS) tool like Git. Copying a directory would make it difficult to update in the future through…
-
Creating Translation Strings
General Rules Source strings should be in English. Make sure all user-viewed text gets run through a translation function. Never translate HTML classes or code. Always use a succinct definition string. Avoid jargon or regional dialect. Sentences should end in punctuation. Avoid repeating phrases when not needed. For…
-
Debugging SSO
How to troubleshoot 3rd party SSO from your localhost setup. Get the 3rd party SSO configuration from GDN_UserAuthenticationProvider. Insert these information in your GDN_UserAuthenticationProvider table. Enable the proper SSO plugin. Edit your /etc/hosts and add the domain name of the 3rd party like so: 127.0.0.1…
-
General Development Troubleshooting
These are some generic tips for addressing problems during an upgrade or installation. Delete cache/addon.php so that the plugin and theme mapping rebuilds itself on the next page load. Set $Configuration['Debug'] = true; in your conf/config.php to reveal full error messages. Remember to remove it when you are done. Clear…
-
Translating Vanilla in Github
Translating Vanilla Want to help us improve our translations? We have a Transifex project for contributing to this. Create an account there and submit your improvements. These docs are for developers working with Vanilla in Github -- typically Enterprise or Open source clients. Need to customize the phrasing just on your…
-
Using Pull Requests to Contribute
We love pull requests! They’re the core of our workflow. All code is added to Vanilla via pull requests (PRs). A pull request is simply a request to merge code from a particular branch into another (usually a feature/significative-name or fix/significative-name or refactor/significative-name branch into master). GitHub’s…
-
Code of Conduct
Adapted from Swift’s Code of Conduct v1.3 for now because a copied code is better than no code. As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating…