Follow these simple instructions to get soEditor up and running on your web server:

 

 

  1. Extract the entire zip into the root of your web server or into the root of the web site that you wish to install soEditor in.
     

  2. Move the SiteObjects.soEditorLite assembly (.dll file) out of the extracted /siteobjects/soeditor/lite/ directory into your application bin directory.
     

  3. In your Visual Studio.Net application project, add a reference to the SiteObjects.soEditorLite assembly in your applications bin directory.
     

  4. Refresh your project tree in the solution explorer window.  Right-click on the siteobjects folder in the project tree and select "Include In Project".  This also compiles the example web forms into your web application and are available at /siteobjects/soeditor/lite/examples/default.aspx.
     

  5. If you extract the package into an alternative directory, you must change the scriptpath property of the soEditor declarations in the example applications to point to the new location in order for the examples to work correctly.
     

  6. Refresh your project tree again in the solution window.
     

  7. To display an instance of soEditor in your web form, use the following inside your form declaration:
    <so:Editor
    Lite Runat="server" id="EditorField"
    Field="EditorField"
    Form="Form1"
    ScriptPath="/siteobjects/soeditor/
    lite/"/>
     

  8. Be sure to substitute the correct values for the Field, Form, and ScriptPath properties.
     

  9. Check and make sure the name property is specified for the form tag and is the has the same value as was specified for the form property of your soEditor instance, otherwise soEditor may not render properly.
     

  10. You can either add properties/values manually by editing the html source, or by switching to design view and editing the soEditor objects properties via the Property Window.
     

  11. Build the application.
     

  12. Online help documentation is also available at:
    http://{www.yoursite.com}/siteobjects/soeditor/lite/docs/dotnet/index.html
     

  13. WARNING: The VS.Net designer uses the style property to position soEditor on the form, be sure to remove the style property from the soEditor instance, it is currently not supported.
     

  14. WARNING: If the MS_POSITIONING property is declared in the body tag generated by the VS.Net designer, your web form may render differently in a client browser than as it appears in the VS.Net designer. This is because the style property is currently not supported by soEditor. It is best to simply remove the MS_POSITIONING attribute from the body tag.