Geodesic Solutions Community Wiki

User Tools

Site Tools

You are here: Auction and Classified Software Support Home » Developers » Addons
developers:addons:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
developers:addons:start [2013/05/07 20:00]
jonyo [Tips on Licensing / Locking to Domain] 		developers:addons:start [2014/10/21 16:28] (current)
geojames
Line 4: Line 4:
 This section will help developers get started with understanding all the different things an addon can do.  It is still very much a work in progress, so if you have questions not answered here, send them to [email protected] and we will be happy to explain things further. This section will help developers get started with understanding all the different things an addon can do.  It is still very much a work in progress, so if you have questions not answered here, send them to [email protected] and we will be happy to explain things further.
  
-The bulk of the documentation for addons is still in the form of an example addon that can be [[https://geodesicsolutions.com/geo_store/customers/index.php?task=downloads|downloaded]] from the "public downloads" section in the client area.  This section of the user manual is meant to compliment the example addon, not replace it.+The bulk of the documentation for addons is still in the form of an example addon that can be [[https://geodesicsolutions.com/geo_store/customers/index.php?task=downloads|downloaded]] from the "public downloads" section in the client area.  This section of the user manual is meant to complement the example addon, not replace it.
  
 ===== Parts of Addons ===== ===== Parts of Addons =====
Line 29: Line 29:
   * Do **not** use period (.) in the folder name as it will cause problems in the software((For one, the addon text exporter uses a . between addon name and auth tag, so export/import text would not work for your addon.)).   * Do **not** use period (.) in the folder name as it will cause problems in the software((For one, the addon text exporter uses a . between addon name and auth tag, so export/import text would not work for your addon.)).
   * Highly recommend using alpha-numeric and underscore (**_**) characters only.  This will ensure best compatibility and reduce/remove any chances of problems in the software itself.   * Highly recommend using alpha-numeric and underscore (**_**) characters only.  This will ensure best compatibility and reduce/remove any chances of problems in the software itself.
-  * Check to make sure the name is not already being used by one of the available official addons released by Geodesic Solutions.  We also recommend checking the addons posted by 3rd party developers on our site http://geoaddons.com.+  * Check to make sure the name is not already being used by one of the available official addons released by Geodesic Solutions.  We also recommend checking the addons posted by 3rd party developers on our site http://geocoregoodies.com.
   * Choose a unique name, perhaps consider adding something unique to you to the beginning of each addon folder you create((For instance what you use for //auth_tag// in the info.php file.)).  Doing this will greatly reduce the chances of compatibility problems from 2 different addons using the same folder name.   * Choose a unique name, perhaps consider adding something unique to you to the beginning of each addon folder you create((For instance what you use for //auth_tag// in the info.php file.)).  Doing this will greatly reduce the chances of compatibility problems from 2 different addons using the same folder name.
  
Line 35: Line 35:
 ===== Advertise your Addons ===== ===== Advertise your Addons =====
  
-We have a website http://geoaddons.com, owned and operated by Geodesic Solutions, LLC. specifically for showcasing 3rd party addons (Addons created by you!).  If you have created your own addon and would like to sell or give it away, register a developer account on http://geoaddons.com and post a listing about your addon on the site.  The http://geoaddons.com website is powered by GeoClassAuctions Enterprise, and uses a lot of the built in features like ability for users to review addons.+We have a website http://geocoregoodies.com, owned and operated by Geodesic Solutions, LLC. specifically for showcasing 3rd party addons (Addons created by you!).  If you have created your own addon and would like to sell or give it away, register a developer account on http://geocoregoodies.com and post a listing about your addon on the site.  The http://geocoregoodies.com website is powered by GeoClassAuctions Enterprise, and uses a lot of the built in features like ability for users to review addons.
  
 You can create your own developer storefront as well once you get a few addons posted on the site that you want to be able to showcase from a single location on the site. You can create your own developer storefront as well once you get a few addons posted on the site that you want to be able to showcase from a single location on the site.
  
-==== geoaddons.com Guidelines ====+==== Geocoregoodies.com Guidelines ====
  
-These guidelines are **for developers** wishing to advertise an addon on geoaddons.com.  Below are the guidelines that your addon must adhere to, in order to advertise your addon by posting it on [[http://geoaddons.com]].+These guidelines are **for developers** wishing to advertise an addon on geocoregoodies.com.  Below are the guidelines that your addon must adhere to, in order to advertise your addon by posting it on [[http://geocoregoodies.com]].  Note that we also **recommend** these guidelines for **any custom / 1-off addon** as well((Yes following the guidelines can take longer, and thus cost more for custom development, for instance taking time to use an addon hook instead of editing the base software...  But it also means less work for each update.  In other words, following these guidelines will cost a little "more now" but save a lot in the long run.  We have seen many a site have to hire a developer to re-do customizations using these guidelines after they find their site is no longer able to be updated without paying an arm and a leg for every update, just to re-apply changes.)), as these are considered "best practices" and good ideas to follow in general.
  
 **Addon Requirements:** **Addon Requirements:**
Line 53: Line 53:
 These guidelines are subject to revision as needed.  If any of the guidelines above are not met, we may **remove your listing** and attempt to contact you to re-post it with any corrections or changes needed. These guidelines are subject to revision as needed.  If any of the guidelines above are not met, we may **remove your listing** and attempt to contact you to re-post it with any corrections or changes needed.
  
-Below are **recommendations** if you plan to post your addon on geoaddons.com:+Below are **recommendations** if you plan to post your addon on geocoregoodies.com:
  
 **Addon Suggestions:** **Addon Suggestions:**
Line 63: Line 63:
   * Try to follow "best practices" wherever possible, and in your addon documentation make sure to advocate best practices.  For instance, you should never have "edit geo_templates/default/..." in the instructions, since you should never edit any templates in the default template set.  We recommend to link directly to user manual pages here on our site when applicable.   * Try to follow "best practices" wherever possible, and in your addon documentation make sure to advocate best practices.  For instance, you should never have "edit geo_templates/default/..." in the instructions, since you should never edit any templates in the default template set.  We recommend to link directly to user manual pages here on our site when applicable.
  
-<tip c n>**Note:**  If you happen to find any addons posted on [[http://geoaddons.com]] that do not follow the requirements above, please let us know.  We do try to review every addon posted but sometimes things can slip through.</tip>+<tip c n>**Note:**  If you happen to find any addons posted on [[http://geocoregoodies.com]] that do not follow the requirements above, please let us know.  We do try to review every addon posted but sometimes things can slip through.</tip>
  
 ==== Tips on Licensing / Locking to Domain ==== ==== Tips on Licensing / Locking to Domain ====
Line 76: Line 76:
  
   * Include the company / author's name in any license related errors, especially any that might "exit" or cause the rest of the script to not load.     * Include the company / author's name in any license related errors, especially any that might "exit" or cause the rest of the script to not load.  
-    * **BAD Example Error:**  //This script is locked to a different domain.// +    * **BAD:**((Bad because there is no way to tell what addon is generating the error.  Customize your errors!!))  //This script is locked to a different domain.// 
-    * **Good Example Error:**  //The Acme Co. Anvil addon is locked to a different domain.//+    * **GOOD:**((Good because the error message generated by the source code protection, was customized to include the author and addon name, so it is crystal clear what is generating the error and who needs to be contacted to fix it.))  //The Acme Co. Anvil addon is locked to a different domain.//
     * We cannot stress this enough...  When someone with a lot of 3rd party addons tries to change domain names, just think of the headache it would cause if each of those addons generated a generic error and none "claimed" the error..  Not to mention extra down-time and frustration, sometimes that frustration gets mis-directed at Geodesic as it appears the main software is creating the error.  So please make sure all error messages include the author and addon name!     * We cannot stress this enough...  When someone with a lot of 3rd party addons tries to change domain names, just think of the headache it would cause if each of those addons generated a generic error and none "claimed" the error..  Not to mention extra down-time and frustration, sometimes that frustration gets mis-directed at Geodesic as it appears the main software is creating the error.  So please make sure all error messages include the author and addon name!
   * If protecting the code, we recommend [[http://ioncube.com|Ioncube]] as that is what the software's licensing files use.  Whatever you use, just remember to customize any error messages to include the author / addon name for any type of errors that it produces.   * If protecting the code, we recommend [[http://ioncube.com|Ioncube]] as that is what the software's licensing files use.  Whatever you use, just remember to customize any error messages to include the author / addon name for any type of errors that it produces.
developers/addons/start.1367956828.txt.gz · Last modified: 2014/09/25 16:55 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki