Указания за поддържане на сайт с VanyoG CMS - vanyog/mycms GitHub Wiki

Настоящите указания са предназначени за крайни потребители, които разполагат с инсталирана и вече функционираща система VanyoG CMS. (Относно начина на изтегляне вижте началната страница, а за пускане в действие на системата - Инсталиране и в допълнение - информацията от файл USAGE.txt).

Инструменти за редактиране на съдържанието на страниците, които представляват допълнителни линкове и менюта, се появяват в самите страници на сайта, когато потребител влезе в сайта с потребителско име и парола и след това отиде на коя да е друга страница. Инструментите за променяне на страниците, които ще види всеки влязъл потребител, зависят от предоставените му от сайт администратора права.

Системата за управление на съдържанието e изградена на модулен принцип. Извличането, показването и редактирането на специализирана информация (качени файлове, новини, галерии снимки, мнения и др.) на страниците на сайта се осъществява от специфични софтуерни модули.

Показва се върху съдържанието на дадена страница, обикновено в десния или левия горен ъгъл, когато потребител имащ право да прави промени по текущата страница, е влязъл през страница за служебен достъп и след това е отворил дадената страница. Менюто се изобразява със значителна прозрачност, така че да не пречи на преглеждането на страниците, и става непрозрачно при поднасяне на курсора на мишката върху него.

Ако менюто за администриране пречи да се достигне до закривани от него линкове, то лесно се скрива с щракване върху линка "close", в горната му част. След скриване, менюто се появява отново на следващата страница или след презареждане на текущата страница.

Ако потребителят има права да създава нови страници и да редактира страници, както и да работи с някои от модулите, менюто за администриране се състои от линкове като:

close
Admin path
Open to edit
Edit mode
Page New
Page From H
Page Crrect H
Page Hide
Page Get
Page Move
UserReg New
admin Изход

Като правило надписите на тези линкове се състоят от две думи: първата означава за какво се отнася линка (Например: Page - ако се отнася до страница; или име на модул, ако се отнася за модул) а втората означава какво действие се извършва с този линк.

На последния ред от менюто се вижда потребителското име на потребителя и линк "Изход" за излизане от системата.

След излизане от системата всички елементи за редактиране на страниците се скриват и сайтът започва да се вижда така както го виждат обикновените посетители.

Линк Admin path отваря директорията за главно администриране. Нормално тази директория трябва да е защитена с парола, известна само на главния администратор на сайта. Така че, след щракване върху линка, трябва да се въведат необходимите потребителско име и парола.

След щракване върху линк "Edit mode" отворената в момента страница, както и всички страници, на които ще се отиде след това, и за които влезлият потребител има права за редактиране, преминават в режим на редактиране. В режим на редактиране линкът "Edit mode" се променя на "Normal mode", а в края на всички надписи, които са взети от различни записи на базата данни и са позволени за редактиране, се показва линк със знак звезда *. Щракването върху лика "Normal mode" връща страницата в нормален режим (както я виждат всички посетители), без линкове със знак звезда *. В режим на редактиране щракването върху линк със знак * отваря страница със заглавие "Редактиране на текст" или друга страница за редактиране на съответна информация.

На страница "Редактиране на текст", която се отваря при щракване на линк * се показват следните елементи:

Името (Name), под което текстът е запазен в базата данни, например: p1045_content.

Списък Modules: на достъпните за използване модули. Вижте по-долу Използване на модули.

Поле Text, което служи за редактиране на съответния текст. Веднага след зареждане на страница "Редактиране на текст", в полето за редактиране се показва html кода на редактирания текст, но ако редактиращият желае, може да щракнe бутона "CKEditor" и да зареди редактор, в който се работи с форматиран текст и форматирането се прави с бутони подобно на редактирането, например, с Word или друг текстов редактор.

Внимание:

Бутонът "CKEditor" трябва да се използва само в случай, че редактираният текст съдържа html тагове като: <p>, </p>, <h1>, </h1>, <strong> и др. подобни, но ако е чист текст без html тагове, използването на CKEditor ще предизвика добавяне на ненужни тагове и ще се развали предвидения външен вид на страниците. Не използвайте CKEditor, когато редактирате заглавията на страниците!

В текстово съдържание от сайта, части от което се генерира от модули, има елементи от вида: <!--$$_ИмеНаМодул_параметри_$$-->. Тези елементи предизвикват извикване на модули, които заместват съответния елемент с генериран от съответен модул HTML код. Не променяйте тези елементи, ако не сте наясно какво е точното им предназначение, описано в документацията на съответния модул.

След извършване на желаните промени в отворения за редактиране текст, за запазване на промените и връщане към страницата съдържаща текста, се щраква бутона "Запазване на промените".

За връщане към страницата, съдържаща редактирания текст без запазване на промени, се щраква линк "Връщане обратно".

Създаването на нова страница се извършва чрез щракване на линка "Page New", което предизвиква отваряне на страница със заглавие "Създаване на нова страница", предназначена за въвеждане на данни за новата страница. Необходимите данни за създаване на нова страница са:

Отметка "Нов раздел" се поставя ако новата страница трябва да е главна страница на нов раздел (подраздел на текущия раздел) от сайта.

"Език" се избира от падащия списък. След като бъде избран език, естествено, всички текстове за новата страница трябва да бъдат на така избрания език.

"Позиция в менюто" е число, което определя на кое място в менюто на текущата страница, да са постави линка към новата страница.

Пояснение: В режим на редактиране пред линковете във всички менюта се появяват числа, обикновено кратни на 10. Подреждането на линковете в менюто става по реда на нарастване на тези числа и при необходимост от променяне на местата на линковете, трябва да се променят тези числа. Например, ако има три линка с позиции 10, 20 и 30, и трябва третият линк да се премести пред първия, числото 30 на третия линк се променя на 5. Така при показване на менюто местата на линковете ще се определят от реда на числата 5, 10 и 20, и третият линк ще заеме мястото на първия. При създаване на нова страница, по подразбиране, числото "Позиция в менюто" е с 10 по-голямо от най-голямото число, задаващо позиция на линк в сайта. Така че, ако не се променя това число, линкът към новата страница ще се появи в края на менюто на текущата страница. При необходимост линкът в менюто да се покаже на друго място, трябва да се обърне внимание на числата пред линковете в менюто и например, ако трябва линкът към новата страница да се покаже между линкове с позиции 90 и 100, се задава позиция 95.

"Текст на линка в менюто" е кратък текст, който ще се показва като линк към новата страница в менюто на текущата страница. Обикновено е по-съкратен вариант на следващия текст "Заглавие". Задава се само ако не е премахната отметката "Линк в менюто на текущата страница".

Отметка "Линк в менюто на текущата страница" - ако е поставена, в менюто на текущата страница ще се създаде линк към новата страница, а ако е премахната, такъв линк няма да се създаде. Тогава не е необходимо да се задава "Текст на линка в менюто". Тази отметка се премахва в случай, че се цели да се направи страница, до която да се стига не през системата от менюта за навигация на сайта, а само чрез нарочно сложени в други страници линкове. Такава страница няма да се показва и в "Карта на сайта".

"Заглавие" е заглавието на страницата. Заглавието се показва: върху лентата за заглавие на браузъра, в "Карта на сайта", в търсачките като google и др., над основния текст на страницата, ако това е предвидено от шаблона на страницата и на други места.

"Съдържание на страницата" е основният текст, който се показва в централната част на страницата. Може да се редактира с помощта на CKEditor и с Copy-Paste в него може да се вмъкват и изображения. (Внимание! Вмъкнатите с Copy-Paste директно в текста на страниците изображения се кодират във вид на обикновен текст, което силно увеличава големината на страниците и забавя тяхното доставяне до посетителя. За вмъкване на изображения е за предпочитане да се използват качени на сървъра отделни файлове с изображения. За качване на файлове вижте модул UPLOADFILE.)

Щракването на бутона "Създаване и отваряне на страницата" създава нова страница според зададената информация и я отваря.

След като страницата бъде създадена отделните ѝ елементи: надпис в менюто, заглавие и съдържание се редактират чрез щракване върху съответния линк със знак *, когато страницата се разглежда в режим на редактиране.

По принцип, изтриването на съществували дълго интернет страници не се препоръчва, защото към такива страници може да сочат много линкове, поставени в други страници на същия сайт, както и на други сайтове. Изтриването на страницата ще направи невалидни всички такива линкове и ще влоши откриваемостта на сайта от търсачките. За предпочитане е, ако съдържанието на дадена страница вече не е актуално, то да се замени с друго актуално съдържание или с текстове и препратки, които насочват към други актуални страници.

Все пак, може да се изтрие страница, направена скоро по погрешка и това става с щракване върху линка "Page Delete" и след отговаряне с щракване на бутона "Yes" в съобщението за потвърждаване на изтриването.

Бутонът "Page Delete" не се показва на страница, която е главна страница на раздел. Главната страница на раздел не може да се изтрие преди да бъдат изтрити, или преместени в други раздели, всички други страници и подраздели от същия раздел. Когато в един раздел е останала само главната му страница, чак тогава може да се изтрие и тази страница и с изтриването ѝ се изтрива и раздела.

Новосъздадените страници са скрити - линковете към тях в генерираните от системата менюта не се виждат от обикновените посетители и съдържанието на скрити страници не се показва на обикновените посетители. Потребители с права да редактират дадена страница в режим на редактиране ще виждат, както линковете към страницата, така и съдържанието ѝ, дори и тя да е скрита. Също така, в менюто за редактиране те виждат линк Page Visible, ако страницата е скрита, и щраквайки върху него превръщат страницата във видима, а когато страницата е видима линкът в менюто за редактиране е Page Hide и щракването върху него прави страницата скрита.

С цел правене по-лесен достъпа на различни потребители до информация, някои страници, разположени в различни раздели, показват идентична информация. Например: графиците за изпити на сайта на университет се показват, както на страница "Графици за изпит" в раздел "Учебен отдел", така и на страница "Графици за изпит" в раздел "Студенти".

Ако се планира да се създаде страница, която да дублира съдържанието на друга страница, първо се създава нова страница, с празно съдържание. После, за да се покаже в новата страница съдържанието на другата страница, се изпълнява командата от менюто за администриране Page Get, когато е отворена новата страница. След щракване върху линка Page Get се показва диалог с поле за въвеждане, в което трябва да се напише номера на другата страница, чието съдържание ще се показва и в текущата страница. След щракване на бутона OK в съдържанието на текущата страница се поставя елемент <!--$$_CONTENT_ИмеНаТекст_$$--> за препращане към съдържанието на другата страница, това предизвиква системата да прочете от базата данни и да покаже на мястото на този елемент съдържанието на другата страница.

В режим на редактиране, в края на текста на страница, съдържаща елемент за препращане към съдържанието на друга страница, се виждат два линка звезди **. Първият от тях отваря за редактиране съдържанието, към което се прави препращане. Ако се редактира това съдържание промените ще се отразят и на двете страници, показващи това съдържание. Ако се щракне върху втория линк *, се отваря за редактиране съдържанието на страницата, от която се прави препращане. То съдържа елемента <!--$$_CONTENT_ИмеНаТекст_$$-->. Над или под този елемент може да се добави съдържание, или може да се премахне този елемент за да се прекрати връзката между двете страниците и съдържанието на препращащата страница да се замени с друго независимо съдържание.

При щракване върху хипервръзката в менюто за редактиране Page Move се показва диалогов прозорец за въвеждане на номера на раздела, в който трябва да се премести текущата страница. Веднага след щракване на бутона OK в този диалог, текущата страница се премества и се отваря отново, но вече в новия раздел.

Модулите служат за автоматично генериране на съдържание, обикновено чрез извличане на информация от базата данни. За да се генерира съдържанието на дадена част от страница с помощта на модул, в HTML кода на страницата, трябва да се вмъкне елемент <!--$$_ИмеНаМодул_Параметри_$$-->. Наличието на частта Параметри в този елемент за някои модули не е необходимо, но при други е задължително.

Информация за предназначението и начина на използване на всеки модул има в README.txt файла в директорията на този модул. На страница "Редактиране на текст", след имената на модулите, за които има такъв файл има линк help, който отваря този файл.

За модулите, които нямат файл README.txt и след имената им няма линк help, може да се получи информация от коментарите в PHP файловете с програмния им код, публикуван тук. Файловете на модули, намиращи се на даден сайт са достъпни за главния администратор на сайта.

Когато в текст, показван на дадена страница, е вмъкнат модул, този модул може да предизвика добавяне на команди в менюто за администриране или поява на нови елементи за редактиране на информацията, свързана с конкретния модул.