Difference between revisions of "Create a Dolibarr local community"

Latest revision as of 13:40, 16 March 2025

Back to home page of
the Dolibarr foundation

This page is a guide line to help local user groups to build their own community around Dolibarr project.

Things required to start

All following things are required to start to manage a local Dolibarr users' group or community. Please do all of this, in same order than provided here. If you want to work into an international project, you must also accept rules, and this page is one of this stupid rule (but not so stupid for us):

Prerequisites

0) Check if a community for your region/country/language already exists. If it does, try to join the existing community instead.

1) You must be a local foundation, or group of friends knowing open source software, or a local company, speaking english to be able to exchange with international foundation.

2) Create an account onto this wiki. Then login to create a page specific with page name that is your personal name (firstname lastname, not your company or foundation name).

For this, once login on this wiki, go on page Firstname Lastname and change URL with your own firstname and lastname, and click on button "Create" after submitting new URL. Then, you can make a copy and paste of content of page Firstname Lastname and replace content with your own personal information. Fill paragraph "Other information / Autres informations / Otra información" to tell what you did or plan to do for Dolibarr. The goal of this is to have a card inside this wiki whose goal is to provide information on all Dolibarr actors. It's also the first time you provide structured and public information to main Dolibarr team (the Dolibarr foundation board team) to let us know you exists.

Also, submit a photo of yourself as a png file from a file that must be named "Firstname Lastname.png" (submit link is link "Upload file" on left menu of this wiki).

(Note: if you receive an antispam message about your web url, add a space between your hostname and first level domain name).

3) If you are a company: Add your name into the category "Other partners" for your country (or into category Preferred Partners if you are already a Preferred Partner), on the page: List of Dolibarr partners and providers (send a mail to contact@dolibarr.org if page for your country does not exists).

4) Check translation for the language of your country is completed and accurate. If not, this is the next step to work on. See page Translator documentation to know how to fix/submit Dolibarr translation).

5) Next step is to check the default setup provided by last version of Dolibarr is complete for your country (list of vat rates, list of states, list of companies type, ...). If not, send us SQL requests to have setup complete into Dolibarr sources installer (See all files into htdocs\install\mysql\data, complete them for your country and send modified files to contact@dolibarr.org).

6) Take a look at the wikipedia project for your language. If no page exists for Dolibarr project, try to add it. Just cut, paste and translate content of english page (https://en.wikipedia.org/wiki/Dolibarr) into a new page of the wikipedia for your language. If a page already exists, try to complete content to match english page (https://en.wikipedia.org/wiki/Dolibarr) and fix typo/translation errors.

Get a community portal ?

The https://www.dolibarr.org is now able to manage all languages in the same web site. So there is no reason to create more portals about Dolibarr. Publishing news on the official one, in your own language is possible. If your language is not supported, ask contact@dolibarr.org to add it.

It is no more recommended to create your own portal. This creates useless duplicates. However, forum may not exists for your language. In such a case, your can create one, and ask us to add the link on the page https://www.dolibarr.org/forum.php

Animate your community

Once all previous steps are done, you are then free to animate your community like you want.

Do all actions you want to do in the way you want. This is some ideas :

Man stands into congress (For example: french community presents Dolibarr into Salon_Solution_Linux_2010, Salon_Solution_Linux_2011, Salon_Solution_Linux_2012).

=> This is the most efficient way to promote Dolibarr !! Because then, you will get Open Source technical guys that will promote it for you.

Organize BarCamp, DevCamp or Dolibarr Day (See index page Category:DevCamps for example of already past devcamps).
Publish news onto local website.
Create social networks groups, promote them and publish news/articles on them.

To help you for tasks of promoting the project, you can use all materials provided by the Dolibarr foundation and available at GitHub repository (Git links available on page https://github.com/DolibarrFoundation/foundation)

You will find kakemono, flyers, logos, business cards, etc, you can translate/reuse.

Things recommended

You are free to animate your community in your own way, but it's suggested to implement the following in order to expand your community.

Translate all the resources you can find from the foundation GIT repository (Git links available on page https://github.com/DolibarrFoundation/foundation), like SVG files for logo creation, rollups or business cards for your language. You can then use them into summits, conferences, forums, trade shows or put them into show rooms or your web site.

This is the two most important point to have a big community :

Post a lot of news onto local web sites, magazines for your country: the more you promote Dolibarr, the more you will get new users, new partners (or new customers if you are a company). When such news appears on a major media, tell us (contact@dolibarr.org).

Man a stand into Opensource congress or forums: This is a very good way to have fun and to help boost the adoption of Dolibarr in your country. If you do so (it's one of the most interesting and efficient things to do), please create a page into this wiki with photo (example: Salon_Solution_Linux_2010). Report page into this wiki should be in English but if you host your own report page, with photos, into your language, send us a link (we will add a link at appropriate place into Dolibarr web sites).

Note:

When all things into chapter "Things required" are completed, if you own a company you may also apply to be a Preferred Partner. See Dolibarr Preferred Partner. It will also be a good thing if you are yourself a member of international Dolibarr foundation. See page Subscribe.

Things allowed

This chapter describes explicit things you can do when you are a community manager of a local community:

Use Dolibarr logo on your web site but use another logo as the trademark of your community.
Use any materials provided by Dolibarr foundation and available into GitHub repository (Git links available on page https://github.com/DolibarrFoundation/foundation). You will find rollups, flyers, guides, logos, templates, etc. You can translate or use them for your need.
Use any other tools of your choice to animate your community (video, wiki, etc...)
Add to any web site related to Dolibarr the same links than the links into the download central page: https://www.dolibarr.org/download/, forum or any other pages of official portal https://www.dolibarr.org
Post any news (in english or in your own language) on official web site, if you have subscribed to the Dolibarr foundation.
Represent Dolibarr into congress, show rooms with no need to ask anything to the Dolibarr foundation.
Create and sells goodies with Dolibarr logo. Revenues are yours. Note that goodies can already by purchase from this web site: https://goodies.dolibarr.org
Drink beers with all Dolibarr friends (but not too much).

Things forbidden

This chapter describes explicit things you can't do when you are a community manager of a local community:

You can't use ads on a Dolibarr local web site that use Dolibarr official logo.
Check that you use correctly the brand name Dolibarr. See the page: Rules to use the brand name "Dolibarr"
If you ask the foundation to publish a news, you can't do it to promote private services. This is what this means: If you are a company with your own services, then description and prices of such services must be on a different web site, with a different name and can't be on a post on www.dolibarr.org or on a community local website. Don't forget that a community portal web pages are the brand of the community project, not a landing page for your business, so a community project and a commercial local web site must remain two different things.

@@ Line 4: / Line 4: @@
-= [[File:Service formation.png|52px]] Things required to start =
+=[[File:Service formation.png|52px]] Things required to start=
-All following things are required to start to manage a local Dolibarr users' group or community. Please do all of this, in same order than provided here. If you want to work into an international project, you must also accept rules, and this order is one of this stupid rule (but not so stupid for us):
+All following things are required to start to manage a local Dolibarr users' group or community. Please do all of this, in same order than provided here. If you want to work into an international project, you must also accept rules, and this page is one of this stupid rule (but not so stupid for us):
-) Check a community for the couple (country/language) you plan to create must not already exists. If it does, try to join the existing community instead.
+==Prerequisites==
+) Check if a community for your region/country/language already exists. If it does, try to join the existing community instead.
-) You must be a local foundation, or group of friends knowing open source softwares, or a local company, speaking english to be able to exchange with international foundation.
+) You must be a local foundation, or group of friends knowing open source software, or a local company, speaking english to be able to exchange with international foundation.
-) Ask an account onto this wiki (ask to contact@dolibarr.org providing your login, lastname, firstname and email). Then login to create a page specific with page name that is your personal name (firstname lastname, not your company or foundation name).
+) Create an account onto this wiki. Then login to create a page specific with page name that is your personal name (firstname lastname, not your company or foundation name).
 For this, once login on this wiki, go on page [[Firstname Lastname]] and change URL with your own firstname and lastname, and click on button "'''Create'''" after submitting new URL.
 Then, you can make a copy and paste of content of page [[Firstname Lastname]] and replace content with your own personal information.
-Fill paragraph "Other informations / Autres informations / Otra información" to tell what you did or plan to do for Dolibarr.
+Fill paragraph "Other information / Autres informations / Otra información" to tell what you did or plan to do for Dolibarr.
 The goal of this is to have a card inside this wiki whose goal is to provide information on all Dolibarr actors.
 It's also the first time you provide structured and public information to main Dolibarr team (the Dolibarr foundation board team) to let us know you exists.
@@ Line 23: / Line 24: @@
 (Note: if you receive an antispam message about your web url, add a space between your hostname and first level domain name).
-) ''If you are a company or a foundation using Dolibarr:'' Add your company name to the following pages [[List of Dolibarr users]]
+) ''If you are a company:'' Add your name into the category "'''Other partners'''" for your country (or into category '''Preferred Partners''' if you are already a Preferred Partner), on the page:
+[https://partners.dolibarr.org List of Dolibarr partners and providers] (send a mail to contact@dolibarr.org if page for your country does not exists).
-(Note: if you receive an antispam message about your web url, add a space between your hostname and first level domain name).
+) Check translation for the language of your country is completed and accurate.
+If not, this is the next step to work on. See page [[Translator documentation]] to know how to fix/submit Dolibarr translation).
-) ''If you are a company:'' Add your name into the category "'''Other partners'''" for your country on the page:
+) Next step is to check the default setup provided by last version of Dolibarr is complete for your country (list of vat rates, list of states, list of companies type, ...). If not, send us SQL requests to have setup complete into Dolibarr sources installer (See all files into '''htdocs\install\mysql\data''', complete them for your country and send modified files to '''contact@dolibarr.org''').
-[[List of Dolibarr partners and providers]] (send a mail to contact@dolibarr.org if page for your country does not exists).
-) Check translation for the language of your country is completed and accurate.
+) Take a look at the wikipedia project for your language. If no page exists for Dolibarr project, try to add it. Just cut, paste and translate content of english page (https://en.wikipedia.org/wiki/Dolibarr) into a new page of the wikipedia for your language. If a page already exists, try to complete content to match english page (https://en.wikipedia.org/wiki/Dolibarr) and fix typo/translation errors.
-If not, this is the next step to work on. See page [[Translator documentation]] to know how to fix Dolibarr translation language files using Transifex online system).
-) Next step is to check the default setup provided by last version of Dolibarr is complete for your country (list of vat rates, list of states). If not, send us SQL requests to have setup complete into Dolibarr sources installer (See all files into '''htdocs\install\mysql\data''', complete them for your country and send modified files to '''contact@dolibarr.org''').
+==Get a community portal ?==
+The https://www.dolibarr.org is now able to manage all languages in the same web site.
+So there is no reason to create more portals about Dolibarr. Publishing news on the official one, in your own language is possible. If your language is not supported, ask contact@dolibarr.org to add it.
-) Take a look at the wikipedia project for your language. If no page exists for Dolibarr project, try to add it. Just cut, paste and translate content of english page (http://en.wikipedia.org/wiki/Dolibarr) into a new page of wikipedia for your language. If a page already exists, try to complete content to match english page (http://en.wikipedia.org/wiki/Dolibarr) and fix typo/translation errors.
+It is no more recommended to create your own portal. This creates useless duplicates.
+However, forum may not exists for your language. In such a case, your can create one, and ask us to add the link on the page https://www.dolibarr.org/forum.php
-) Now, you can create a dedicated web site for your country called the "Dolibarr XXX portal" where XXX is your country. You can use tool of your choice for that. We recommend however Joomla as it is CMS used for other existing Dolibarr portals. This might be an important work. Also, if using Joomla, you will be able to reuse the same template than dolibarr.org portal. Joomla template for Joomla 1.5.* is available into GIT repository: {{FoundationGitUrl}} (into dir "joomla").
+=[[File:Humour.png]] Animate your community=
-) The logo used on your web portal must match the logo found on dolibarr.org except it must includes the name of the country/community under it. For example, for France, logo should contains France under it, like found into http://www.dolibarr.fr
+Once all previous steps are done, you are then free to animate your community like you want.
-Having a logo showing "Dolibarr TheCountry", is a way to say customer it's not another different project with same name, but the same, just declined for "TheCountry". However, it's not enough, and experience shows that web site that does not comply with dolibarr.org skin, are just web sites discarded by users, journalists, and rest of community. See next chapter to solve this.
-Also, the Dolibarr foundation will NOT pay for Google adwords campaigns to promote your web site if it uses a too different logo (just because we know this is against productive for you and project).
-) Put on top of your "Dolibarr XXX portal", a link with flags to others majors communities (for the moment, link to international web site http://www.dolibarr.org, french portal http://www.dolibarr.fr and spanish portal http://www.dolibarr.es). Links must appears on TOP of Home page and be visible by visitor with no need to move and scrollbar. If main links are at bottom, of you page, just add visible flags at top.
+Do all actions you want to do in the way you want. This is some ideas :
-Also, the Dolibarr foundation will NOT pay for Google adwords campaigns to promote your web site if this rule is not applied (today users trust only international solution, and we know that not doing this is a a marketing error making everybody waste its time).
-) Your portal must provide a demo area.
-If you offer a commercial hosting solution, you must show, onto same page, both links to your commercial solution and link to a free shared online demo. Also links to your commercial solution must point to another page than the demo page and prices must appears only on this second page, not on main demo page.
-Just take a look at page used on dolibarr.org to see how it must be: http://www.dolibarr.org/onlinedemo
-Goal is to keep a separation between OpenSource project and commercial offers. Don't think this rule will slow down your business, our experience show it is the opposite. Users don't trusts a project that start to show prices (they just do not enter into demo. Trust us, everybody wins to match this rule.
-Also, the Dolibarr foundation will NOT pay for Google adwords campaigns to promote your web site if this rule is not applied (just because we know working like this is a waste of time).
-) Having too many different Dolibarr, with different looks create a threat for customers, thinking your web site is a "parallel" different project. So try to avoid this, it deserve your goal and users will not trust your web site. So try to keep same skin (colors) and same entries into horizontal menu than dolibarr.org.
-Also, the Dolibarr foundation MAY not pay for Google adwords campaigns to promote your web site if it uses a too different look.
-) If you don't plan to animate a dedicated social networks, add, on front page of your portal web site, links to official (english) Dolibarr social Networks. You will find list of links on page [[FAQ How to be informed on news about Dolibarr project ?]]. Using a box "Social Networks" like the one found on http://www.dolibarr.org is a good thing. If you want to animate your own local social Networks, you can replace international links with yours, but try to always keep a link at least for "Facebook", "Twitter" and "Google+" (use english links if you don't covers them for your language).
-The Dolibarr foundation will also edit the dolibarr.org portal to add link of your web site into "local communities" box.
-) If you don't plan to animate a dedicated forum (it is better having no forum than having a forum you don't answer), add a link to official (english) Dolibarr forum (http://dolibarr.org/forum) with text "Forum (english only)".
-) Add a google analytics tag into all of your portal pages. Then add the dolibarr foundation email (assodolibarr@gmail.com) to be allowed to have read only access on Google analytics views or setup your Google analytics to send monthly reports to the foundation Google analytics account (assodolibarr@gmail.com).
-Note: To share a readonly access to statistics of a site, go onto home statistics page of this site into google analytics, then click onto the linke "Admin" on top bar on the left. Then click on tab "Users" and add assodolibarr@gmail.com as a new user.
-) ''If you are a foundation only:'' Install Dolibarr to manage your members and create a generic account for international foundation and sent it to '''contact@dolibarr.org''' (you will probably start with only two or three members, we started like this too !).
-) Once all steps are done, this means you are ready to animate your community (see next chapter).
+*Man stands into congress (For example: french community presents Dolibarr into [[Salon_Solution_Linux_2010]], [[Salon_Solution_Linux_2011]], [[Salon_Solution_Linux_2012]]).
-Let us know by email to '''contact@dolibarr.org''' (Note: sending us email more frequently to show us where you are is better).
-We will check your online site, and if the foundation owns the TLD domain dolibarr.xx for your country, we will make (if all previous steps are ok) a redirected for the domaine name to your web site. If domain name for your country is not owned by foundation yet, you can buy it by yourself. If domain is already owned by someone else, the foundation can provide you a domain like xx.dolibarr.org with xx as your country code.
-= [[File:Humour.png]] Animate your community =
+=> This is the most efficient way to promote Dolibarr !! Because then, you will get Open Source technical guys that will promote it for you.
-Once all previous steps are done, you are then free to animate your community like you want.
-Do all actions you want to do in the way you want. This is some ideas :
+*Organize BarCamp, DevCamp or [[Dolibarr Days|Dolibarr Day]] (See index page [[:Category:DevCamps]] for example of already past devcamps).
-* Man stands into congress (For example: french community presents Dolibarr into [[Salon_Solution_Linux_2010]], [[Salon_Solution_Linux_2011]], [[Salon_Solution_Linux_2012]]).
+*Publish news onto local website.
-* Create social networks groups, promote them and publish on them.
+*Create social networks groups, promote them and publish news/articles on them.
-* Organize Barcamp or devcamp (For example: [[Compte_rendu_Hackweek_2010]]).
-* There is no bad idea (only efficient or not)...
-To help you for such tasks, you can use all materials provided by the Dolibarr foundation and available at GitHub repository ({{FoundationGitUrl}})
+To help you for tasks of promoting the project, you can use all materials provided by the Dolibarr foundation and available at GitHub repository ({{FoundationGitUrl}})
-You will find rollups, flyers, logos, business cards, etc you can use.
+You will find kakemono, flyers, logos, business cards, etc, you can translate/reuse.
-= [[File:Astuces.png]] Things recommanded =
+=[[File:Astuces.png]] Things recommended=
-You are free to animate your community like you want. But following this list of advices is recommanded to have your community growing.
+You are free to animate your community in your own way, but it's suggested to implement the following in order to expand your community.
-* Translate all resources you can find into the foundation GIT repository ({{FoundationGitUrl}}), like SVG files used to create logos, rollups or business cards for your language. You can then use them into congress, forums, trade show or put them into show rooms or your web site.
+*Translate all the resources you can find from the foundation GIT repository ({{FoundationGitUrl}}), like SVG files for logo creation, rollups or business cards for your language. You can then use them into summits, conferences, forums, trade shows or put them into show rooms or your web site.
 This is the two most important point to have a big community :
-* Post a lot of news onto local web sites, magazines for your country: the more you promote Dolibarr, the more you will get new users, new partners (or new customers if you are a company). When such news appears on a major media, tell us (contact@dolibarr.org).
+*Post a lot of news onto local web sites, magazines for your country: the more you promote Dolibarr, the more you will get new users, new partners (or new customers if you are a company). When such news appears on a major media, tell us (contact@dolibarr.org).
-* Man a stand into Opensource congress or forums: This is a very good way to have fun and to make Dolibarr growing into your country. If you do so (it's one of the most interesting and efficient thing to do), please create a page into this wiki with photo (example: [[Salon_Solution_Linux_2010]]). Report page into this wiki should be in English but if you host your own report page, with photos, into your language, send us a link (we will add a link at appropriate place into Dolibarr web sites).
+*Man a stand into Opensource congress or forums: This is a very good way to have fun and to help boost the adoption of Dolibarr in  your country. If you do so (it's one of the most interesting and efficient things to do), please create a page into this wiki with photo (example: [[Salon_Solution_Linux_2010]]). Report page into this wiki should be in English but if you host your own report page, with photos, into your language, send us a link (we will add a link at appropriate place into Dolibarr web sites).
 Note:
-When all things into chapter "Things required" are completed, if you are a company you may also apply to be a Preferred Partner. See [[Dolibarr Preferred Partner]].
+When all things into chapter "Things required" are completed, if you own a company you may also apply to be a Preferred Partner. See [[Dolibarr Preferred Partner]].
-It will also be a good thing if you are yourself a member of internationnal Dolibarr foundation. See page [[Subscribe]].
+It will also be a good thing if you are yourself a member of international Dolibarr foundation. See page [[Subscribe]].
-= [[File:Road_sign_green.png|20px]] Things allowed =
+=[[File:Road_sign_green.png|20px]] Things allowed=
 This chapter describes explicit things you can do when you are a community manager of a local community:
-* Use Dolibarr logo on your web site (However, it is recommanded to add the name of the country under the logo to clearly show your are a local community affiliated to internationnal one).
-* Use any materials provided by Dolibarr foundation and available into GitHub repository ({{FoundationGitUrl}}). You will find rollups, flyers, guides, logos, templates, etc. You can translate or use them for your need.
-* Use any other tools of your choice to animate your community (video, wiki, etc...)
-* Add your own Google Adwords tags (but ads must be limited to 2 by pages). All gains are yours. The more you promote Dolibarr (see previous chapter, the more you will increase traffic and the more you may earn).
-* Add links to any other Dolibarr web site (local or international) like the download central page: http://www.dolibarr.org/download/ , forum or any other pages
-* Post news (english language only) onto official Dolibarr mailing-lists (user, dev) to annouce availability of your community.
-* Represent Dolibarr into congress, show rooms with no need to ask anything to the Dolibarr foundation.
-* Create and sells goodies. Revenues are yours.
-* Use your community tools to promote some commercial services (such services must however all be related to Dolibarr), except SaaS/Cloud hosting services (there is always official SaaS/Cloud international hosting services so no need to add more/yours).
-* Drink beers with all Dolibarr friends (but not too much).
-= [[File:Road_sign_red.png|20px]] Things forbidden =
+*Use Dolibarr logo on your web site but use another logo as the trademark of your community.
+*Use any materials provided by Dolibarr foundation and available into GitHub repository ({{FoundationGitUrl}}). You will find rollups, flyers, guides, logos, templates, etc. You can translate or use them for your need.
+*Use any other tools of your choice to animate your community (video, wiki, etc...)
+*Add to any web site related to Dolibarr the same links than the links into the download central page: https://www.dolibarr.org/download/, forum or any other pages of official portal https://www.dolibarr.org
+*Post any news (in english or in your own language) on official web site, if you have subscribed to the Dolibarr foundation.
+*Represent Dolibarr into congress, show rooms with no need to ask anything to the Dolibarr foundation.
+*Create and sells goodies with Dolibarr logo. Revenues are yours. Note that goodies can already by purchase from this web site: https://goodies.dolibarr.org
+*Drink beers with all Dolibarr friends (but not too much).
+=[[File:Road_sign_red.png|20px]] Things forbidden=
 This chapter describes explicit things you can't do when you are a community manager of a local community:
-* A community portal content must be into main language of your community and only main language (you can build a multi-language portal if your country has several dialect, what is important is not provide a couple (language/country) already covered by another portal). If you want to offer visibility to another couple (country/language), you must instead refer to links to existing portal that manage this couple.
+*You can't use ads on a Dolibarr local web site that use Dolibarr official logo.
-* Publishing news (online or press) into English that point to your local web site: If you publish a news into English, you can, but link must point to www.dolibarr.org. To publish news that link to your web site, you must publish a content that is in same language than your web site.
+*Check that you use correctly the brand name Dolibarr. See the page: [[Rules to use the brand name "Dolibarr"]]
-* Use community tools of your country (portal or social network) to promote your own SaaS/Cloud hosting services. If you have yours, it must be on a different portal, with a different name (For example "DoliSaas, a web hosting service of Dolibarr"). Don't forget that a community portal serve project, not your business (even if it helps), and this are two different things. You can have links between each other, have crossed promote texts, except for SaaS/Cloud hosting as there is already official SaaS/Cloud international hosting services, so no need to promote more/yours. If have your hosting offer, create another web site, and avoid to promote it on community portal.
+*If you ask the foundation to publish a news, you can't do it to promote private services. This is what this means: If you are a company with your own services, then description and prices of such services must be on a different web site, with a different name and can't be on a post on www.dolibarr.org or on a community local website. Don't forget that a community portal web pages are the brand of the community project, not a landing page for your business, so a community project and a commercial local web site must remain two different things.
-* Using more than 2 ads on a Dolibarr local community portal page is forbidden.
-What happens if prerequisites are no more covered ?
-Dolibarr is free, everybody too, so you can still decide to discard prerequistes or do forbidden things. We will not fight against your freedom, but keep in mind:
-* The trademark "Dolibarr" is a registered trademark, registered to protect the project. Do not use it to deserve project.
-* Dolibarr local communities are attractive because they are legitimated by all others:
-Dolibarr project is promoted by local communities like local portals are promoted by all others, including the Dolibarr foundation and all Dolibarr tools (the main international portal, the wiki documentation, the official dolistore.com market place, the doliforge.org external module development forge) but also by some pages inside software itself, or from a lot of other resources. If you deserve the project, the foundation may remove all backlinks toward your portal, to promote instead another team/community that does not deserve project. Local communities are strong when project is strong and project is strong when local communities are too, so every body sharing same destiny, this should never happen.