Professional Documents
Culture Documents
Notas: Este manual slo contiene informacin que no est ya contenida en la ayuda en ventanas emergentes (help.html) disponibles en el rea de administracin. Este documento tambin contiene instrucciones para la instalacin del Ncleo. Si eres un desarrollador, documentacin de desarrollo adicional est disponible.
Tabla de contenidos
Acerca de Nucleus CMS Licencia: GPL Instalacin Pieles y la modificacin de las plantillas Aspectos de seguridad Aspectos de rendimiento Lo que est permitido / no permitidos en los comentarios? XML-RPC Interface Solucin de problemas (FAQ) Consejos y Sugerencias Problemas conocidos Historial de la versin Crditos y agradecimientos
Acerca de Nucleus
Ncleo es un Sistema de Gestin de Contenidos (CMS): un potente conjunto de scripts PHP que le permite mantener uno o ms weblogs o diarios en lnea. Un breve resumen de las caractersticas ms importantes es la siguiente: Se ejecuta en su propio servidor Uno o ms blogs, incluso en la misma pgina Plugin de interfaz para aadir funcionalidad adicional Comentarios Archivo Categoras Bsqueda Varios autores Elementos de futuro Corrientes de aire Amplia rea de administracin La biblioteca de medios y carga de archivos Totalmente personalizable pieles y plantillas La piel de importacin / exportacin
Banlist contra el abuso de sistema de comentarios Sindicacin RSS Fcil instalacin Copias de seguridad de fcil XML-RPC interfaz (la aplicacin de la API de Blogger y API metaWeblog ) XHTML-listo Herramientas para importar blogs de Blogger y Greymatter ...
Requisitos para ejecutar Ncleo:(Si usted no sabe si se ajustan a los requisitos, pregntele a su
administrador del sistema)
PHP (versin 5.0.0 o superior, pueden funcionar en la versin 4.0.6 o superior) El acceso a un MySQL base de datos (versin 4 o superior) Algunos HTML y CSS del conocimiento, para editar las pieles y plantillas Ncleo est diseado para las personas que quieren el control total y "tweakability sobre sus sitios. Si lo que buscas es una forma muy sencilla de poner un sitio, o no saben nada de HTML, es posible que desee utilizar un 'simple' de servicios comoBlogger .
Licencia
Ncleo: PHP / MySQL Weblog CMS (http://nucleuscms.org/) Copyright (C) 2002-2007, el Grupo Ncleo Este programa es software libre, puede redistribuirlo y / o modificarlo bajo los trminos de la Licencia Pblica General GNU publicada por la Free Software Foundation, versin 2 de la Licencia, o (a su eleccin) cualquier versin posterior. Este programa se distribuye con la esperanza de que sea til, pero SIN NINGUNA GARANTA, incluso sin la garanta implcita de COMERCIALIZACIN o IDONEIDAD PARA UN PROPSITO PARTICULAR. Vea la Licencia Pblica General de GNU para ms detalles. Usted debe haber recibido una copia de la Licencia Pblica General de GNU junto con este programa, si no, escriba a la Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, EE.UU.. Su posesin de este software, el usuario acepta estas condiciones. Por favor, elimine la copia de este software si usted no est de acuerdo con estos trminos.
Instalacin
Nota: Si va a actualizar, debera ver la instrucciones de actualizacin en el sitio web del Ncleo. Ncleo de la instalacin se realiza a travs de algunos pasos:
1. Descomprimir
Descomprimir todos los archivos en un directorio de tu ordenador. Asegrese de que los nombres de ruta se utiliza cuando descomprimir. Usted debe terminar con la siguiente estructura de directorios (* representa un nmero de archivos):
/ * (Archivos principales de sitio) / Ncleo / * (archivos principales de administracin de la zona) / Ncleo / javascript / * (javascript scripts de ayuda) / Ncleo / libs / * (bibliotecas del ncleo central) / Ncleo / lenguaje / * (definiciones de idiomas) / Ncleo / plugins / * (plugin-dir) / Ncleo / XMLRPC / * (interfaz XML-RPC) / Ncleo / documentation / * (+ Documentacin de administracin del rea de ayuda) / Ncleo / estilos / * (hojas de estilo para documentos y administracin de rea) / Ncleo / forms / * (esqueletos de commentforms etc) / Extra / * (beneficios extras, por ejemplo, los archivos necesarios para que las direcciones URL de fantasa) / Skins / * (directorio de skins [pieles importadas se ve aqu]) / Media / * (biblioteca multimedia directorio [emtpy])
2.Subir archivos
Subir todos los archivos a su servidor, utilizando el programa de FTP favorito.Asegrese de cargar. Php de archivos en modo ASCII! Puede que no funcione de otra manera.
Opcional:
1. Para hacer que su proceso de instalacin ms fcil, puede cambiar los permisos de archivo de config.php a 666. De esta manera, el script de instalacin ser capaz de actualizar automticamente en lugar de lo que tiene que hacer manualmente. (Gua rpida sobre cmo cambiar los permisos de archivo) 2. Si desea utilizar la carga de archivos, usted tendr que agregar permisos de escritura para el directorio / media /. Esto es necesario para permitir PHP para escribir los archivos subidos en ese directorio. El directorio debe ser chmod ded a 777 (Gua rpida sobre cmo cambiar los permisos de archivos). (Si usted tiene acceso a la raz, en su lugar puedechgrp el directorio para el usuario que est ejecutando el httpd proceso (por lo general httpd o nadie , y luego chmod 775 del directorio). 3. Si desea utilizar el plugin SkinFiles para editar los archivos, tendrs que cambiar los permisos de todos los archivos y directorios en el directorio / skins / directorio. Para poder editar los archivos, deben ser chmod ded a 666 ( Gua rpida sobre cmo cambiar los permisos de archivos ). Para poder crear nuevos archivos o directorios, el directorio padre debe chmod ded a 777 .
3. Ejecutar install.php
Abra su navegador web de cdigo abierto la URL a continuacin, en el que adaptar la tusitio y yourpath partes. http://www.yoursite.com/yourpath/install.php Esta instalacin-script le pedir alguna informacin, y realizar la mayor parte de la instalacin para usted. Cuando todo se ha logrado, install.php le dar ms instrucciones. (De todos modos tendr que borrar algunos archivos manualmente)
Nota: Cuando se abre install.php en tu navegador y ve el texto "Si usted ve este texto en su navegador ...", o se le pedir que descargue 'install.php', entonces su servidor web no es compatible con PHP , y usted no ser capaz de ejecutar Nucleus all.
4. Hecho!
Ahora debera ser capaz de visitar su sitio en http://yoursite.com/weblog/ (o lo que los mapas de URL a la ubicacin donde has subido los archivos del sitio ncleo principal)
Pieles y plantillas
Introduccin
Volver al manual Por lo tanto, ya ha instalado Nucleus ... Tienes varias opciones ahora en relacin con el aspecto de tu sitio: 1. 2. 3. 4. Vaya con el skin por defecto / plantillas que viene con el ncleo Inicio de la piel default / plantillas y modificar a sus necesidades (colores, etc ..) Comience su propia piel / templates, y definir sus propias hojas de estilo CSS Descargar una de las docenas de pieles libre disponible en el sitio Ncleo Skins .
Tabla de contenidos
HTML y CSS El skin por defecto Plantillas vs Skins Cmo se eligen las pieles Como: Un "Aadir artculo" forma en su sitio web El uso de CSS para definir el aspecto de las formas Habilitacin de votos karma 'Editar item'-links Escrito con pieles de exportacin / importacin en cuenta
HTML y CSS
Al editar las pieles y plantillas, necesitar al menos unos conocimientos bsicos de HTML y CSS. Esta seccin proporciona algunos consejos a los tutoriales en lnea y referencias: W3Schools : clases particulares en lnea de construccin web (HTML, XHTML, CSS) CSS Gua de pnico : enlaces a varios recursos CSS Webmonkey: Principios bsicos de HTML
Webmonkey: Hojas de estilo Dive Into Accessibility : libros en lnea, no es realmente acerca de HTML, pero la accesibilidad y cmo hacer que su sitio sea ms accesible.
Plantillas vs Skins
En el ncleo, tanto de las plantillas y las pieles se utilizan para determinar la forma en tu blog se ve. Entonces, cul es la diferencia entre estos dos? 1. Skins definir cmo buscar sitios. Cada piel se compone de varios tipos: uno para el ndice principal, una de las pginas opcin detallada, una para el archivo, ... Las pieles tambin contienen instrucciones de dnde incluir un weblog, y que la plantilla se debe utilizar para hacerlo. 2. Ja! Esto significa que las plantillas se utilizan para definir la forma en que el bloque del blog en su pgina parece. La razn por la que las plantillas no estn incluidos en los propios skins, es que varias pieles pueden utilizar la misma plantilla para mostrar un blog. Un ejemplo se da en la siguiente imagen. Toda la pgina se define por una piel, mientras que las partes en los rectngulos de color rojo (lista de categoras y el contenido de blog) con formato de acuerdo a las plantillas. Es la piel que se define en los rectngulos de color rojo aparecer.
Qu tipo de piel?
artculo archivo archivelist archivelist bsqueda miembro
Deducidos de itemid Weblog por defecto, o blogid atributo archivelist -atributo Default weblog Weblog por defecto, o blogid atributo Ninguno Ninguno (ventana emergente con la ? Imagepopup =.. imagepopup imagen) (Otros o vaco) ndice Weblog por defecto, o blogid atributo Junto a estos 7 tipos, hay un error de tipo, que se utiliza cuando se producen errores.
La cascada de la piel
El cuadro anterior tambin indica cmo el blog para que se muestre que se elija. La piel que se usar, es el skin por defecto para ese weblog, seleccionado en la configuracin de ese weblog. No todas las necesidades de la piel que las definiciones de todas las partes de la piel. Cuando una parte ha desaparecido, la piel llamado "default" se usar en su lugar (ver ms abajo). Esto le permite, por ejemplo para crear una sola pgina de error y una pgina de miembro.
El 'default' Piel
Ncleo requiere que en todo momento existe una piel llamada ' por defecto '. Esta es la piel a la que se apoya en una skinpart falta. Si el skinpart mismo es tambin falta en el 'default' la piel, el mensaje de error "no encuentra la piel adecuado" se mostrar. Otra razn por la que "por defecto" la piel es necesario, debe ser capaz de mostrar mensajes de error cuando no hay blog es seleccionado (por ejemplo, el "no blog, 'error)
1. El cdigo JavaScript
En primer lugar, es necesario incluir el cdigo Javascript edit.js poniendo la siguiente lnea en algn lugar entre el head y </ head>. Este archivo contiene las funciones que se necesitan para hacer el trabajo de la vista previa y para ocultar / mostrar el formulario "Aadir artculo". <Script type = "text / javascript" src = "ncleo / javascript / edit.js"> </ script>
4. El 'add item'-link
Y el toque final: un enlace o botn para activar la visibilidad de la forma. Se dan dos ejemplos. El primero es un simple enlace: <a href="javascript:showedit();"> elemento aadir </ a> El segundo ejemplo es un botn oculto en la esquina superior izquierda <Div style = "position: absolute; izquierda: 0px; top: 0px; Ancho: 10px; height: 10px " onclick = "javascript: showedit ();"> </ Div>
Tipo de formulario
Piel Variable
Aadir el artculo a blog <%% Additemform> . Blogform Agregar Comentario <%% Commentform> . Commentform Login Form <%% LoginForm> . LoginForm Formulario de bsqueda <%% SearchForm> . SearchForm Miembro de Correo para Miembros <%% Membermailform> . Formulario de email A continuacin se muestra una visin general de las clases CSS asignadas a los botones y campos de entrada.
Tipo
Los campos de entrada (de texto y textarea) . FormField Botones . Formbutton Un ejemplo de cmo utilizar estas clases en que las hojas de estilo es la siguiente: / * Se aplica a todos los campos de entrada * / . FormField { background-color: gris; } / * Slo se aplica a los botones de formularios de comentarios * / . Commentform. Formbutton { border: 1px solid # 000; background-color: # ddd;
color: # 000; font-size: xx-large; } En el ejemplo anterior, todos los formfields que genera el ncleo se les da un fondo gris, y el botn de enviar en el formulario de comentarios tiene un texto grande, un borde de 1px negro, texto en negro y un fondo de color gris claro.
"Editlink'-plantilla
El 'Editar Link'-templatepart define cmo una' edicin item'-link es el formato. Por defecto, el contenido es el siguiente: <A href = "<%% editlink>" onclick = "<% editpopupcode%>"> editar </ a> Si prefiere editar el elemento en el rea de administracin, en lugar de en el marcador emergente, utilice el siguiente cdigo: <A href = "ncleo / index.php? Action = itemedit & Itemid = <% itemid%>"> editar </ a>
El posicionamiento de la edicin-link
Junto a la plantilla "editlink ', est el <% editar%> -templatevar que, cuando se coloca en alguna parte del tema "body'-templatepart, inserta el editlink. Vea el ejemplo de la howto karma votos para ver un ejemplo.
El prefijo Incluye tambin juega un papel. Esta es la vista / parte Una visin general de la configuracin correcta: Nombre : vista Tipo de contenido : text / html Incluyen el modo : Use la piel dir Incluya el prefijo : vista /
Edicin de la piel
El IncludeMode y IncludePrefix configuracin har que la incluyen , phpinclude y parsedinclude skinvars para obtener los archivos desde el skindir. Junto a esto, est el skinfile skinvar, que se traduce en su argumento a una direccin URL relativa al skinsdir. En nuestro caso: <% Skinfile (myFile.jpg)%> Se expanden a: http://example.org/skins/vista/myFile.jpg Vamos a ir fcil en nosotros mismos y definir el diseo global en dos archivos llamados pagefoot.inc y pagehead.inc , que ponemos en nuestra vista / directorio: pagehead.inc <DOCTYPE html PUBLIC "- / / W3C / / DTD XHTML 1.0 Strict / / EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xml:lang="es" xmlns="http://www.w3.org/1999/xhtml"> <head> <title> mi web </ title> <Link rel = "stylesheet" type = "text / css" href = "<% skinfile (layout.css) %>" /> </ Head> <body> <div id="contents"> pagefoot.inc </ Div ><!-- fin contenido div -> <div id="stuffbar"> <h2> Navegacin </ h2> <ul> <li> <a href = "<% todaylink%>"> Hoy </ a> </ li> <li> <a href = "<% ArchiveLink%>"> Archivo </ a> </ li> </ Ul> <h2> Acerca de </ h2>
<ul> <li> <a href="http://www.nucleuscms.org/"> Ncleo </ a> Power </ li> </ Ul> </ Div ><!-- fin stuffbar -> </ Body> </ Html> El contenido de la skinparts se convierte en especie de trivial: (yo no los voy a definir todo, usted consigue el punto de ver a los ms importantes) Indice principal <% Parsedinclude (pagehead.inc)%> <h1> mi blog </ h1> <% Blog (vista / principal, 10)%> <% Parsedinclude (pagefoot.inc)%> Pginas del artculo <% Parsedinclude (pagehead.inc)%> <h1> mi blog </ h1> <h2> artculo </ h2> <Elemento% (vista / detallado)%> <h2> Comentarios </ h2> <% Comentarios (vista / detallado)%> <h2> Agregar comentario </ h2> <%% Commentform> <% Parsedinclude (pagefoot.inc)%> Tenga en cuenta que puse el nombre de mis plantillas de vista / principal y vista / detallada . Hace ms fcil ver las cosas a seis meses ms tarde. Ambas plantillas son en realidad clones que he hecho de la omisin y detallada las plantillas que vienen con el ncleo. Archivo de la lista <% Parsedinclude (pagehead.inc)%> <h1> mi blog </ h1> <Archivelist% (vista / principal)%> <% Parsedinclude (pagefoot.inc)%>
Archivo <% Parsedinclude (pagehead.inc)%> <h1> mi blog </ h1> <% Archivo (vista / principal)%> <% Parsedinclude (pagefoot.inc)%>
Exportacin de la piel
Cuando todo est hecho, puede exportar la piel de la piel de importacin / exportacin de pgina en el rea de administracin. Esto es lo que debe hacer: 1. Seleccione Vista, Vista / detallada y vista / principal de la piel y la lista de plantillas 2. Agregue un poco de descripcin textual y golpear la piel de exportacin seleccionados / templates botn. Va a generar un skinbackup.xml para usted. 3. Guardar este skinbackup.xml archivo junto con los otros archivos en la vista / directorio. 4. Paquete de todos los archivos del directorio de vista dentro de un archivo zip 5. Ya est! Su piel ahora puede ser compartida con otros
Aspectos de seguridad
mySQL contraseas
Desde el ncleo necesita conectarse a una base de datos MySQL desde un script PHP, la contrasea de la base de datos deben ser almacenados en un archivo PHP. En sistemas multi-usuario, esto puede causar un riesgo de seguridad unevitable: En algunos sistemas, otros usuarios podrn leer su informacin de acceso. Es posible que desee ponerse en contacto con su operador de sistema para averiguar qu tan seguro es para almacenar informacin sensible dentro de PHP-scripts.
El problema anterior es comn a todos los scripts PHP que necesitan conectarse a una base de datos. Como usuario, por lo general hay nada que puedas hacer al respecto con el fin de hacer las cosas 100% seguro. Slo queremos que usted sea consciente de este peligro potencial.
Galletas
Ncleo utiliza cookies para almacenar informacin del usuario de inicio de sesin. Esto podra causar un riesgo de seguridad cuando las cookies son robados. A pesar de que su contrasea no puede derivarse de la galleta (los valores almacenados en la cookie es el nombre de usuario y una cadena generada aleatoriamente) , podra haber formas de "falsa" la cookie en otro equipo y por lo tanto para ser conectado pulg
Aspectos de rendimiento
En contradiccin con algunos otros weblog / scripts en lnea de revistas, Ncleo de no generar una versin esttica de todos los elementos. Esto significa que cada vez que se solicita una pgina, el intrprete PHP se llama y la base de datos se accede a crear de forma dinmica la pgina solicitada. Para los sitios web de pequeo tamao, esto no debera causar ningn problema. Para los sitios web que reciben decenas de visitas por segundo, el efecto sobre el desempeo de los sistemas no se sabe realmente. Hasta el momento no se han reportado problemas por los usuarios de Nucleus (algunos sitios se estn ejecutando muy grande en l, con 30 o ms blogs en una sola instalacin).
cada secuencia de tres nuevas lneas en el cuerpo es reemplazado por una nueva lnea nica (por qu: la disposicin) Etiquetas HTML se sustituyen por las entidades el comentario se recorta (inicial y final que queda de) URL son "hreffed. Para evitar la presentacin lo-ups, las direcciones URL se acortan. Por el momento, todas estas reglas y los parmetros estn programadas en el cdigo.
XML-RPC Interface
La direccin del Ncleo XML-RPC interfaz es: http://www.yourserver.com/yourpath/nucleus/xmlrpc/server.php XML-RPC es un formato para las llamadas remotas por medio de mensajes XML. Suena complejo, pero la aplicacin de una interfaz XML-RPC en una aplicacin permite a otros servicios para comunicarse con l. En la actualidad, existen tres APIs compatibles: la API de Blogger , la API metaWeblog, y el API de Movable Type .Si desea un ejemplo de un cliente que utiliza estas interfaces, intente w.bloggar (Windows) o Ecto (MacOS). Las llamadas a disposicin de la interfaz se describe en la documentacin de desarrollo, que puede ser descargado por separado, o ver en lnea.
de cambiar el blogsettings. (Por ejemplo, puede crear un archivo vaco y subirlo). Acerca de los permisos de archivo, asegrese de que el archivo de actualizacin es chmod ded a 666 y los directorios chmod ded a 755. ( Gua rpida sobre cmo cambiar los permisos de archivo ) No quiero que la interfaz XML-RPC para estar disponible Usted puede simplemente borrar el xmlrpc / sin causar problemas. No quiero sindicacin RSS (titulares) que est disponible Puede eliminar el xml-rss.php (headlines.php) y el archivo "xmlrss (titulares) de la piel / plantilla
Problemas conocidos
Algunos problemas conocidos / errores: En el momento del lanzamiento, hay apoyo oficial herramientas de blog de conversin disponibles para Ncleo v3.3.Tenemos un conjunto de cdigo con el que puede iniciar, y estn proporcionando enlaces a las herramientas de importacin creadas por otros. Un buen punto de partida es tambin el ncleo del Foro seccin de preguntas de importacin. Debido a que todos los sistema de blogs tienen una estructura diferente que no es posible convertir cada sistema en otro, sin una posible prdida de informacin.Los autores del guin de tratar de minimizar los problemas y la prdida de informacin. Ctrl + Maysculas + Un acceso directo puede entrar en conflicto con ICQ / Trillian Cuando PHP se ejecuta en modo seguro, es muy probable que haya problemas cuando se utiliza el directorio de los medios de comunicacin (Ncleo no ser capaz de detectar automticamente el tamao de la imagen, o no permitir la carga) Las entidades pueden llegar en mal estado en el canal RSS (por ejemplo, y se convierte en &) La opcin de notificar a la direccin-en blogsettings tiene un lmite preestablecido de 255 caracteres, lo que significa que no se puede poner demasiadas direcciones de correo electrnico en ese pas. Vista previa en directo no funciona correctamente en Mozilla Internet Explorer 6 parece ser ocasionalmente itsself de cierre despus de la adicin de un elemento. El elemento se agrega, sin embargo. (Que ha sido un tiempo desde la ltima queja de que, por lo que podra haber desaparecido)
Crditos y agradecimientos
No importa cunto nos esforcemos, algunas personas de forma involuntaria por alto en esta seccin.
Fundador
Wouter Demuynck
Presentaciones cdigo
Andy Matsubara Armon Toubman Edmond Hui alias Gregor gregorlove Kai Greve alias kg Joel Pan alias ketsugi Kimitake Legolas Niels Leenheer alias rakaz Rodrigo Moraes Jeroen Budts Appie Verschoor alias xiffy (Bsqueda de texto completo) Muchos otros ...(Ver la historia)
Bibliotecas, etc
Jeff MacMichael (NP_SkinFiles plugin) Ivan Fong, Roel, Moraes, Hcgtv (Ncleo 3.2 skin por defecto) Los plugins son escritos por sus respectivos autores. Gracias debe salir a la gente que escribi el lenguaje de los archivos del ncleo. Usted puede descargar archivos de idioma adicionales en la pgina web del ncleo. El logotipo (el que los rayos amarillos) fue creada por Rodrigo Moraes La piel RSS 2.0 fue creado por Xiffy La interfaz XML-RPC utiliza el 'XML-RPC para PHP "la aplicacin de tiles Inc. La copia de seguridad / restaurar el codigo es en gran parte inspirado en el cdigo utilizado en phpBB. El cdigo JavaScript utilizado para la vista previa instantnea se inspir originalmente en el cdigo utilizado por Mijn te Kop (holands) y milov.nl. La bala mundo junto a los enlaces en la pantalla de administracin, viene de QBullets
Gracias!
Muchas gracias tambin debe ir a todas las personas que han ayudado a Ncleo para convertirse en lo que es hoy. Una lista de los donantes est disponible en el sitio web de Ncleo. Un agradecimiento especial a los moderadores del foro y visitantes frecuentes foro.