MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
Descargo de responsabilidad
Este software está escrito con el mayor cuidado en términos de seguridad y
estabilidad. Sin embargo, nunca se puede descartar por completo un riesgo
de seguridad. Tenga en cuenta que no asumo ninguna responsabilidad por
los daños causados por el uso inadecuado entrando a los archivos generados
en el servidor local o mal uso de este software.
Instalación y inicio rápido
Prerrequisitos y configuración
Para utilizar este software sin limitaciones, se deben cumplir las siguientes
condiciones:
• Servidor local o espacio web con suficiente espacio en disco
(dependiendo del tamaño de los archivos que desea cargar para
compartir)
• Funcionalidad PHP
• Acceso FTP o funcionalidad similar para cargar archivos en su espacio
web
• Capacidad para alojar y ejecutar archivos .htaccess en su espacio web
(generalmente en servidores web Apache)
Paso a paso
La instalación de SYSCCDIGITAL es muy fácil. Aquí está la explicación paso
a paso:
• En primer lugar, debe cargar todo el contenido de la carpeta
"sysccdigital" en el destino del servidor local o servidor web deseado
utilizando un Cliente FTP o un mecanismo de carga equivalente.
• Después de que todo esté cargado y listo, debe navegar a la carpeta
de instalación raíz del software con su navegador.
• Ahora verá una interfaz de instalación junto con descripciones que lo
guiarán a través del proceso.
• Cuando la configuración se ha ejecutado correctamente, el software
está listo y se puede usar.
Guía rápida de uso del software
En el menú "Mis enlaces" puede ver todos los enlaces creados. Justo
después de la instalación, todavía no habrá enlaces.
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
Haga clic en "+ Nuevo enlace" para comenzar a cargar sus archivos y crear
el enlace. Cuando se crea su enlace, haga clic en "Ver como cliente" y envíe
el enlace a su destinatario.
Para cualquier configuración general, consulte el menú "Ajustes".
Uso
Crear enlaces
Justo después de la instalación, todavía no habrá enlaces. Si desea crear
uno de inmediato, haga clic en el botón "+ Nuevo enlace" o simplemente
arrastre los archivos que desea cargar a la ventana del navegador (solo
navegadores nuevos).
En el menú de carga, ahora puede ingresar un nombre para su enlace, así
como una contraseña y una nota para el cliente. También puede desactivar
la caducidad del archivo, que eliminará su enlace después de un período de
tiempo específico para ahorrar espacio en el servidor. Con un clic en cargar,
los archivos se cargarán y se creará el enlace. Cuando finalice la carga,
puede distribuir el enlace para sus destinatarios.
Todos los enlaces creados se pueden ver y editar en el menú "Mis enlaces de
archivos". Desplácese sobre uno de los enlaces y haga clic en los iconos
respectivos para 'Papelera', 'Restablecer vencimiento' o 'Editar'
En el modo de edición, puede editar el enlace haciendo clic en el botón
"Editar enlace" en la esquina superior derecha.
También puede eliminar o cambiar el nombre de archivos individuales
pasando el cursor sobre ellos y haciendo clic en los iconos respectivos.
Se pueden crear nuevos subdirectorios haciendo clic en el enlace "Crear
nuevo subdirectorio" en la sección del título. Una vez creado el directorio,
puede abrirlo y agregar archivos con el botón "Agregar archivos".
Funcionalidad técnica
Este software establece un script de índice global, como índice de directorio
para sus subdirectorios usando .htaccess, por lo tanto, es posible generar
una lista de archivos dinámicos para el contenido de un directorio sin la
necesidad de un index.php o index.html para el directorio.
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
Ajustes
Se puede acceder al menú de configuración haciendo clic en el botón
"Ajustes" en la navegación principal a la izquierda.
A la izquierda del menú de configuración, encontrará opciones generales que
se explican al pasar el cursor sobre el pequeño '?'.
A la derecha, puede cargar una imagen de título, que se mostrará en la
parte superior derecha de cada enlace del enlace compartido y se puede
usar para mostrar el logotipo.
Si no desea que se muestre una imagen, puede eliminarla haciendo clic en
el pequeño ícono de la papelera al lado.
En la parte inferior derecha del menú, tiene una información sobre el tacho
de basura, que es donde se colocarán los enlaces después de haberlos
eliminado. Puede restaurarlos o eliminarlos por completo.
En el menú de ajustes, puede establecer la siguiente configuración:
Contraseña del área de administración: con esta contraseña puede
iniciar sesión en el área de administración.
Nombre del servicio: aquí es donde se puede establecer el nombre de su
empresa o un nombre específico para su servidor de archivos.
El nombre del servicio aparecerá en la parte superior de las páginas de la
lista de archivos.
Contraseña maestra: si se establece, todos los enlaces deberán
desbloquearse utilizando esta contraseña o la contraseña definida dentro del
pw.txt de la carpeta del enlace individual. Deje en blanco si no desea la
protección de contraseña por defecto para cada enlace.
Color base: el color base determinará el color primario para el diseño de
color de las páginas de la lista de archivos. Use el selector de color para
obtener una vista previa y elegir un color de su agrado.
Habilitar coloración: se puede usar para activar / desactivar la coloración
automática en caso de que desee usar su propio CSS.
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
Idioma: Esto configurará el idioma de la interfaz. Puede ayudar a traducir
SYSCCDIGITAL agregando un archivo respectivo a la carpeta 'idiomas' del
software.
Caducidad del archivo: escriba la cantidad de días que desea que sus
enlaces de archivos estén en línea. El software eliminará automáticamente
las carpetas antiguas para ahorrar espacio en el servidor. También puede
deshabilitar esta función estableciéndola en 0.
Tamaño máximo de archivo zip: esta configuración determinará el
tamaño máximo en megabytes del contenido de un enlace en el que la
opción "Descargar esta carpeta completa como zip" todavía está disponible.
El límite máximo de memoria de su servidor se completará automáticamente
aquí; es probable que los límites más altos causen errores. Cámbielo, si
quiere un límite diferente.
Espacio total disponible: se utiliza únicamente para mostrar la sección
"espacio en disco en uso" en la parte inferior de la navegación. Si ingresa 0,
se utilizará el espacio en disco disponible de los servidores, pero no se
considerarán las cuotas posibles.
Habilitar miniaturas: define si las miniaturas de las imágenes se
mostrarán al pasar el mouse sobre los archivos en una lista de archivos.
Imagen del título actual: se mostrará en la parte superior de cada enlace
y se puede usar para mostrar su logotipo.
Papelera: las carpetas eliminadas manualmente se almacenarán aquí hasta
que las elimine o las recupere.
Protección con contraseña
Agregar protección con contraseña a sus enlaces
Es posible establecer una contraseña para enlaces individuales o para cada
enlace de forma predeterminada.
Contraseña maestra
Si desea que todos los enlaces estén protegidos por contraseña de forma
predeterminada, simplemente configure la contraseña maestra durante la
configuración en el menú "Ajustes". Ahora será necesario desbloquear todos
los enlaces con la contraseña maestra que configuró.
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
Protección de contraseña individual
Si desea establecer una contraseña para un enlace individual, todo lo que
necesita hacer es especificar una contraseña cuando cree un nuevo enlace.
PRECAUCIÓN: Tenga en cuenta que esto no es una protección de
contraseña de alta seguridad, por lo tanto, si tiene datos muy
confidenciales, ¡no confíe únicamente en ellos! Las contraseñas se
almacenan en hash.
Nombre de usuario y campo de contraseña (BETA)
También es posible tener una protección de usuario y contraseña para
enlaces individuales. Esta funcionalidad aún no está completamente
incorporada en el panel de administración. Si aún desea utilizar un
formulario de nombre de usuario y contraseña, abra su carpeta de enlaces
con un Cliente FTP y busque el '__pw.txt'. Edítelo para tener (exactamente)
dos líneas, donde la primera línea es el nombre de usuario y la segunda
línea es la contraseña.
El respectivo 'pw.txt' podría verse así:
• adminccdigital
• contraseña123
El script detectará esto automáticamente y agregará un campo de entrada
de nombre de usuario al formulario.
Arquitectura del Software
Estructura HTML
La estructura HTML del enlace del cliente es muy simple y está organizada
de la siguiente manera (simplificación):
El marcado generado dinámicamente se ilustra entre corchetes.
<!-- BEGIN HEADER -->
<div id="title">
<h1 id="title-headline">[SERVICE NAME]</h1>
</div><!-- end div#title --->
<!-- END HEADER -->
<!-- BEGIN FILE LIST -->
<div id="list-wrapper">
<div id="list-title">
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
<table><tr><td class="folder-icon"></td><td
class="foldername"><h2>[FOLDER NAME]</h2>Created <strong>[TIME SINCE
CREATION]</strong> ago</td><td id="title-last-td">[EXPIRATION
STRING]</td></tr></table>
</div><!-- end div#list-title -->
<table id="file-list">
[GENERATED TABLE CODE]
</table>
<div id="list-zip">
<div id="progressbar"></div>
<p id="zip-percentage">0%</p>
<table><tr class="clickable"><td class="zip-icon filetype-
icon"><div></div></td><td class="filename"><a id="makezip"
href="javascript:void(0)" title="Download all files in a zip
archive">Download this whole folder as zip</a></td><td class="align-
right">
<script>
document.write("Note: this may take a few moments!")
</script>
<noscript>Note: JavaScript must be
enabled!</noscript></td></tr></table>
</div><!-- end div#list-zip -->
</div><!-- end div#list-wrapper -->
<!-- END FILE LIST -->
Como se ilustra, el marcado se divide en dos secciones, a saber, el
encabezado y la sección de la lista de archivos.
Dentro de la sección de la lista de archivos, las columnas de la tabla
generadas dinámicamente tienen la siguiente estructura:
<tr class="clickable" onclick="window.location.href='[FILE LINK]';">
<td class="select-indicator"></td>
<td class="icon-cell [FILE EXTENSION]-icon">
<div>
<div></div>
<div class="bottom-div"></div>
</div>
</td>
<td class="filename">
<a href="[FILE LINK]" title="[FILE NAME]" class="file-
link">[FILE NAME]</a>
<span class="chooser">
<a href="[DOWNLOAD LINK]">Download</a> | <a href="[FILE
LINK]">View</a>
</span>
</td>
<td>[FILE CREATION]</td>
<td class="align-right">[FILE SIZE]</td>
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
</tr>
Explicación del código PHP
SYSCCDIGITAL es un software de archivos digitales, lo que significa que no
hay clases utilizadas o definidas con él. Todas las funcionalidades se basan
en funciones, que sirven resultados específicos o cálculos necesarios para
generar la lista de archivos.
Las funciones principales para la salida de la lista de archivos se pueden
encontrar en functions.php.
Las funcionalidades específicas de todos los archivos de script se pueden
encontrar a continuación.
Este software consta de 16 archivos php, que son:
1. sysccdigital.php
2. functions.php
3. settings.php
4. setup.php
5. ajax.php
6. download.php
7. delete_old_folder.php
8. root.php
9. 404.php
10.unlock.php
11.protect.php
12./admin/admin-functions.php
13./admin/ajax.admin.php
14./admin/editlink.php
15./admin/index.php
16./admin/login.php
17./admin/preferences.php
Archivos CSS y estructura
Este script está usando tres archivos CSS.
El primero (normalize.css) es un archivo de reinicio genérico. Muchos
navegadores interpretan el comportamiento predeterminado de los
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
elementos html de manera diferente. Al usar un archivo CSS de reinicio
general, podemos solucionar esto.
Este archivo también contiene algunos estilos generales, como colores de
etiqueta de anclaje, tamaños de fuente, etc. Tenga en cuenta que estos
valores pueden anularse en otro lugar del archivo.
El segundo archivo (spectrum.css) es la hoja de estilo del complemento
selector de color del espectro.
El tercer archivo (main.css) contiene todos los estilos específicos de la
página. El archivo se separa en secciones usando:
/* =================================================================
Estilos base: valores predeterminados
=============================================================== */
-- estilos para el fondo funcionalmente y una mejor compatibilidad
/* =================================================================
Estilos de sitio
================================================================ */
/* ================= General ===================== */
Estilo General
/* ================= Title Section =============== */
Estilos para la sección del título
/* ================= List Title Section ========== */
Estilos para la columna de título de la lista de archivos
/* ================= File List Section =========== */
Estilos para la lista de archivos en sí
/* ================= Zip Section ================= */
Estilos para la sección zip en la parte inferio
/* ================= Icons ======================= */
Define los iconos de tipo de archivo
/* ================= Admin Area ================== */
Estilos del área de administración
JavaScript
Este script importa siete archivos Javascript.
1. jQuery
2. modernizr
3. spectrum.js
4. tinycolor.js
5. main.js
6. plugins.js
7. admin.js
“Entrega siempre más de lo que se espera de ti” – Larry Page
MANUAL TECNICO DESARROLLADO E
IMPLEMENTADO POR:
SYSCCDIGITAL V1.0.1 JHON TRUJILLO DIAZ
Historial de versiones
• Versión 1.0.1- error de análisis de URL, error del buscador, modo de
acceso implementado y corregido.
• Versión 1.0 - correcciones de errores importantes, actualizaciones de
seguridad y mejoras de usabilidad, soporte multilingüe agregado,
diseño receptivo agregado, coloración por generación dinámica de
archivo colorize.css en lugar de manipulación DOM, carpeta central
para todos los datos cargados, eliminación de carpeta arreglado,
configuración guardar error corregido.
• Versión beta 0.8 - se corrigió un error que causaba problemas en
versiones anteriores de PHP
• Versión beta 0.1 - Lanzamiento inicial
“Entrega siempre más de lo que se espera de ti” – Larry Page