helpcenter/Web/Controls/Help/Server/Community/CommunityServerCustomModules/CommunityServerCustomModules.es.ascx

<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>

<script runat="server">
    protected override void Init()
    {
        PageTitle = PageCaption = "Modo de añadir módulos personalizados al ONLYOFFICE Groups";
        MetaKeyWords = "";
        MetaDescription = "Aprenda cómo añadir sus propios módulos al ONLYOFFICE Groups.";
    }
</script>
<div class="main_buscall_container dataBackup">
    <div class="MainHelpCenter">
        <h1 class="subHeaderFeaturesCaption TipsCaption">Modo de añadir módulos personalizados al ONLYOFFICE Groups</h1>
        <cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/VariousControls/Versions/CommunityServer/CommunityServer_Current.ascx" />
        <div class="keyword_block">
            <ul>
                <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/server-version/server-version.ascx" /></li>
                <li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/community-server/community-server.ascx" /></li>
            </ul>
        </div>
        <h2 id="introduction">Introducción</h2>
      <div class="block_of_step">
         <div class="screen_text">
             <p>Si Usted desea crear sus propios módulos para ONLYOFFICE y añadirlos al <b>ONLYOFFICE Groups</b>, ahora puede fácilmente hacerlo. Proyecto de ejemplo está disponible aquí: <a target="_blank" href="https://github.com/ONLYOFFICE/CommunityServer/tree/master/web/studio/ASC.Web.Studio/Products/Sample">https://github.com/ONLYOFFICE/CommunityServer/tree/master/web/studio/ASC.Web.Studio/Products/Sample</a></p>
             <p>Puede modificar este ejemplo o crear un nuevo módulo personalizado en su base. Asegúrese de que todos los componentes necesarios están disponibles en las carpetas especificadas y ciertas líneas de código se añaden a los archivos especificados como se describe a continuación.</p>
         </div>
      </div>
        

        <h2 id="Howitworks">Cómo funciona</h2>
    <div class="block_of_step">
        <div class="screen_text">
            <ol>
                <li>Obtenga <b>ONLYOFFICE Community Server</b> de <a target="_blank" href="https://github.com/ONLYOFFICE/CommunityServer">https://github.com/ONLYOFFICE/CommunityServer</a></li>
                <li>El Proyecto de <code>Ejemplo</code> está disponible en la carpeta <code>Productos</code> aquí:
                    <p><a target="_blank" href="https://github.com/ONLYOFFICE/CommunityServer/tree/master/web/studio/ASC.Web.Studio/Products">https://github.com/ONLYOFFICE/CommunityServer/tree/master/web/studio/ASC.Web.Studio/Products</a></p>
                </li>
                <li>El <code>ASC.Api.Sample</code> está disponible en la carpeta <code>ASC.Api</code> aquí:
                    <p><a target="_blank" href="https://github.com/ONLYOFFICE/CommunityServer/tree/master/module/ASC.Api">https://github.com/ONLYOFFICE/CommunityServer/tree/master/module/ASC.Api</a></p>
                </li>
                <li>Las siguientes líneas de código se añaden al archivo <a target="_blank" href="https://github.com/ONLYOFFICE/CommunityServer/blob/master/build/msbuild/build.proj">https://github.com/ONLYOFFICE/CommunityServer/blob/master/build/msbuild/build.proj</a>:
<pre><code>&lt;!-- Sample --&gt;
&lt;ProjectToBuild Include="$(ASCDir)web\studio\ASC.Web.Studio\Products\Sample\ASC.Web.Sample.csproj"/&gt;
</code></pre>
                    <p>y</p>
<pre><code>&lt;ProjectToBuild Include="$(ASCDir)module\ASC.Api\ASC.Api.Sample\ASC.Api.Sample.csproj"/&gt;
</code></pre>
                    <p>También puede ver otros proyectos existentes para aprender donde estas líneas deben ser añadidas.</p>
                    <div class="notehelp nh_important"><span class="important_notice_label">¡Tenga en cuenta, por favor!</span> El orden en que se teclean las líneas es muy importante.</div>
                </li>
                <li>El <code>ASC.Api.Sample.SampleApi</code> se añade al archivo <code>web\studio\ASC.Web.Studio\web.autofac.config</code> de esta manera:
<pre><code>&lt;component
          type="ASC.Api.Sample.SampleApi, ASC.Api.Sample"
          service="ASC.Api.Interfaces.IApiEntryPoint, ASC.Api"
          name="sample"/&gt;
</code></pre>
                </li>
                <li>El archivo <code>Build.bat</code> puede ser ejecutado aquí:
                    <p><a target="_blank" href="https://github.com/ONLYOFFICE/CommunityServer/blob/master/build/Build.bat">https://github.com/ONLYOFFICE/CommunityServer/blob/master/build/Build.bat</a></p>
                </li>
            </ol>
        </div>
    </div>

        <h2 id="Ownmodules">Cómo crear su propio módulo para ONLYOFFICE</h2>
    <div class="block_of_step">
        <div class="screen_text">
            <ol>
                <li>Cree un proyecto de aplicación web de ASP.NET (ASC.Web.Sample) y póngalo en la carpeta <code>...web\studio\ASC.Web.Studio\Products\Sample</code>.
                    <div class="notehelp nh_important"><span class="important_notice_label">¡IMPORTANTE!</span> El nombre del archivo de salida dll debe ser "ASC.Web.*.dll".</div>
                </li>
                <li>Conecte las referencias necesarias de <code>...\web\studio\ASC.Web.Studio\bin\</code>:
<pre><code>ASC.Common.dll
ASC.Core.Common.dll
ASC.Data.Storage.dll
ASC.Web.Core.dll
ASC.Web.Studio.dll
</code></pre>
                </li>
                <li>Implemente la interfaz del <code>IProduct</code> en el archivo <code>ProductEntryPoint.cs</code>.
                    <div class="notehelp nh_important"><span class="important_notice_label">¡IMPORTANTE!</span> El ProductID debe ser único Guid (en VS2012 se genera como <code>TOOLS</code> -> <code>GUID</code> -> <code>New GUID</code>)</div>
                </li>
                <li><div class="notehelp nh_notice">Añada las siguientes líneas al archivo <code>AssemblyInfo.cs</code>:</div>
<pre><code>[assembly: Product(typeof(ASC.Web.Sample.Configuration.ProductEntryPoint))]
</code></pre>
                </li>
                <li>Herede el Master de <code>web\studio\ASC.Web.Studio\Masters\BaseTemplate.master</code></li>
                <li>Establezca la ruta de salida en las propiedades del proyecto de esta manera:
<pre><code>&lt;OutputPath&gt;..\..\bin\&lt;/OutputPath&gt;
</code></pre>
                    <p>para crear las estructuras en la carpeta <code>web\studio\ASC.Web.Studio\bin</code>.</p>
                </li>
                <li>El proyecto se puede construir manualmente o usando el constructor. Para el último añada las siguientes líneas al archivo <code>build\msbuild\build.proj</code>:
<pre><code>&lt;ProjectToBuild Include="$(ASCDir)web\studio\ASC.Web.Studio\Products\Sample\ASC.Web.Sample.csproj"/&gt;
</code></pre>
                    <p>y ejecute el archivo <code>build\Build.bat</code>.</p>
                </li>
                <li>Después de la estructura, ejecute el sitio web en la dirección <code>localhost:port</code>, vaya a la página de <b>Ajustes</b> de "Módulos y Herramientas" (<a target="_blank" href="http://localhost:port/management.aspx?type=2">http://localhost:port/management.aspx?type=2</a>) y active el nuevo módulo <b>Ejemplo</b>. Después éste estará disponible en el menú desplegable del encabezado del portal o usando el enlace directo: <a target="_blank" href="http://localhost:port/products/sample/default.aspx">http://localhost:port/products/sample/default.aspx</a></li>
            </ol>
            <p>Ahora Usted puede crear API para su propio módulo siguiendo <a target="_blank" href="<%=VirtualPathUtility.ToAbsolute("~/server/community/community-server-create-api.aspx")%>">estas instrucciones</a>.</p>
        </div>
    </div>

    </div>
</div>