documentation.txt

开源MARC数据处理

PhpMyLibrary 2.0.1

Oct 22, 2002


	1. R E Q U I R E M E N T S

	Tested Windows 98 SE accessible in the internet:
	See Actual Installation at http://consag.tij.uia.mx/phpmylibrary/index.php
	
		Apache 2.0.42			http://www.apache.org
		MySQL 3.23.39			http://www.mysql.com
		PHP 4.2.3				http://www.php.net		
		phpMyAdmin 2.2.7-pl1 	http://phpmyadmin.sourceforge.net

	Tested at Linux at phpmylibrary sourceforge demo site:
	http://phpmylibrary.sourceforge.net/phpinfo.php for more info.
	See demo at http://phpmylibrary.sourceforge.net/html/modules/PhpMyLibrary
		
		PHP 4.1.2 
		Apache/1.3.26
		MySQL 3.22.27
		phpMyAdmin 2.2.7-pl1

	Tested at on my PC Pentium II at Windows 2000 
	http://localhost/PhpMyLibrary
	
		
		PHP 4.2.2
		Apache/2.0.40 
		MySQL 3.23.52-nt 
		phpMyAdmin 2.2.7-pl1
		
	I've include my php.ini and httpd.conf here. The configuration files that
	I used in my computer during the development. 
	
	Note: You must install 
	
	PHP 4.2.2 at your c:\php 
	 
	Apache/2.0.40 Apache at c:\Program Files\Apache Group\
	
	MySQL 3.23.39 at c:\mysql
	
	phpMyAdmin 2.2.7-pl1 and PhpMyLibrary-2.0.1 at c:\htdocs\
	
	
	Copy the configuration files at
	
	PhpMyLibrary/polerio/docs/win2k/ directory.	
	
	Copy-paste the php.ini to c:\winnt\
	Copy-paste the httpd.conf to c:\Program Files\Apache Group\Apache2\conf
	
	The httpd.conf used the c:\htdocs as its htdocs directory
	thus you must copy all your web-files in there including the PhpMyLibrary
	it is at c:\htdocs\ directory
	
	for your convenience I also added my phpmyadmin config.inc.php file in here.
	I've used the phpMyAdmin 2.2.7-pl1 version.
	
	I suggest you to use phpmyadmin so that your mysql database are manageable at your 
	local web server.
	
	Now accessed your PhpMyLibrary at http://localhost/PhpMyLibrary
	phpmyadmin at http://localhost/phpmyadmin		
	
	if you doesn't have phpmyadmin you will do your database management at the command
	prompt, the old way. first go to your dos, c:\mysql\bin
	then type mysql, create a database, PhpMyLibrary
	
	for more instruction open the file mysql-configure.txt		
		

	2. I N S T A L L A T I O N
	
		a) Get your phpmylibrary.sql at PhpMyLibrary/polerio/sql/ directory
		b) Configure your database file conf.php at PhpMyLibrary/polerio/config/ directory
		c) Configure your Library parameters at PhpMyLibrary/polerio/module/config/ directory
		d) Access your site http://yourlocalhost/PhpMyLibrary/
		e) Edit your account. Login as username admin and password admin, then change your password.
		f) Go to letter 'c' to further configure your library settings, like name, address, logo, etc. 
		
		Additional
		
		g) Edit files in your PhpMyLibrary/themes/ directory. You can copy-paste in theme in here.
		   Open http://consag.tij.uia.mx/phpmylibrary/index.php for actual application of Themes 
		   Download themes http://www.nukethemes.de,  http://www.vipixel.com, etc. for free themes.
		   
		h) Manage your Library(must login as admin). 
		
				1.  Try to add data using cataloging form. Click Catalog.
				2.  Test your MARC/ISIS import feature.
				3.  Try to add some accession numbers to your bibliographic info.
					To do this you must edit your book. An option to add/edit/delete accession 
					numbers will occur.
				4.  Try to add sample users. Regular user, admin, etc..
				5.  Test the online borrowing.
		
		i) Double check the PhpMyLibrary features. 
			
				1. WebOPAC - this is the online public access catalog. You can use this
							 to search the book they want.
							 
				2. Cataloging Function - it is here that you will encode new bibliographic info.
						      i.e. 100 00$aPolerio Babao
						      	   245 01$bPhpMyLibrary Software Documentation
						      	   260   $aPhilippines 2002 							

							  Note: 
							  		
							  	You must have at least title or author in your bibliographic entry.
							  	The PhpMyLibrary searches only at following fields: Title, Author, Publisher, Subject, Notes.
							  	The tags are 245, 100, 260, (650 or 630), 500 respectively.
				
				3.MARC or CDS/ISIS Import/Export - it is in this function you are allowed to import your
								existing bibliographic records. Whether be it in MARC standard or in CDS/ISIS output file.
								
								If you have an existing record saved in your file. You can just import it to the PhpMyLibrary
								and you're done. The bibliographic entry of your book is already searchable to the internet or intranet.
								
								If you have a CDS/ISIS  ISO files, you can also export it to the PhpMyLibrary. With this 
								no encoding will be done because this software included the CDS/ISIS->MARC conversion.
								
				 4. Online Reservation Feature - if you can borrow online already at your library web site then you are
				 				using the Online Reservation Feature of the Library. This is a complicated function
				 				this includes the adding/deleting/editing of users, accession numbers and bibliographic infos.
				 
				 5. Miscellaneous functions:
				 
				 				polGenSQL.py - it uses python and mysqldb(mysql adapter for python) to smoothly
				 							   export your existing MARC data into PhpMyLibrary.
				 							   
				 				Theming System - if you have change already the deafult PhpMyLibrary design/theme then you already
				 							    experience the advantage of theme system.  
				
	2. S U P P O R T
	
		a)  If your installation did'nt work then try to browse the user email archive.
		    https://sourceforge.net/mailarchive/forum.php?forum_id=2919
			It is from here that you might find an answer similar to what you experience in installing the software.
		
		b)  If still you can't find the solution for your problem then do email me at [e-mail]
		
		c)  To receive an automatic updated news directly to your mail box about PhpMyLibrary then subsribe to the mailing lists
			http://lists.sourceforge.net/mailman/listinfo/phpmylibrary-users
			It is from here I commonly send important announcement about PhpMyLibrary.



	3. N O T E
	
		a)  The Multi-admin functionality is not available to post-nuke usres yet.
			It only detects the currently log-in uid of the nuke users. If it find the
			uid of 2 then it's the administrator.
			
	4. T H E M E S Customization
		
		a)  You can edit the theme images because it was saved as PNG, editable at Macromedia 
			Fireworks. You can replace any text there with your Library name.
			The PhpMyLibrary-2.0.1 Version uses mBloctec. Open it at your themes directory
			to modify/customize its HTML/Images.
			
	5. C O N T E N T Management
	
		a) 	The content management has been included in this version. 
			You can now add some information in your library within this library automation software.
			You only have to put it into your PhpMyLibrary/polerio/contents/ directory 
			One thing that is good in that feature is that, if the program detected your filename
			as a txt file then it will be outputted as text file. If it's HTML then the 
			output will be is in HTML. 
			
			This simple documentation that you are reading is one of the
			example of this function. This file was save from your PhpMyLibrary/polerio/contents
			directory. This is a text file. HTML file will also work. HTML is important because
			you might need to use <b>bold</b> or <i>italic</i> letter which doesn't work
			on text file.
						
			This is useful if you wanted to provide an information about your website.
			
			
	6. C R E D I T S
	
	CREDITS 

		Oct 22, 2002

		Polerio Babao of Philippines

			- Stand-alone and Post-module programmer/developer of PhpMyLibrary

		Mr. Adalid Ortiz

			- Submitted a lot of bugs in the software which leads to
			further enhancement/modification of the modules.
		
		Prof. Ma. Divina Pascua Cruz
	
			- Suggested the feature of adding/deleting of user picture
		
		www.postnuke.com www.phpnuke.org
	
			- I adapted thier Theme System Concept which has been applied to stand-alone version
			of the software.
	
		ADODB
	
			- The PhpMyLibrary SQL calls was being interpreted wholly by the ADODB implementation.
	
		Sascha Herpers
	
			- MARC to CVS Concept. Development underway. PhpMyLibrary Developer
		
		Mentalbloc Theme
			- author : jai.wilson / mentalbloc design
			- http://mentalbloc.da.ru
			- [e-mail]
	
		Ateneo Theme
			- GennerR. Cerna
			- Web Developer, Computer Center
			- cernagenr at central.adzu.edu.ph
			- Ateneode Zamboanga University
			
		
	
		Detailed Information can be found at your PhpMyLibrary/polerio/docs/ directory.
		
		
		Thank you for using this software.
		Polerio Babao III
		[e-mail]
		http://phpmylibrary.sourceforge.net