diff --git a/README.md b/README.md index 9de0fd2..386fc99 100644 --- a/README.md +++ b/README.md @@ -13,17 +13,15 @@ GAMEYE.app collection mobile App model and tools for Pharo. -![image](https://user-images.githubusercontent.com/49183340/225460239-aa9b1bff-e7c0-41ed-a2c7-f2947dbeb2c0.png) +![image](https://github.com/labordep/PharoGameye/assets/49183340/b61ddd5a-8a14-405d-8a15-638c645d6e3b) ## Functionnalities -- Gameye App model : ```Collection```, ```VideoGame```, ```System```, ```Peripheral```, ```ToyToLife``` and ```PrintMedia```. +- Gameye App model : ```Collection```, ```VideoGame```, ```System```, ```Peripheral``` (with ```Controller``` and ```Accessory```), ```ToyToLife``` and ```PrintMedia```. - Exported spreadsheet parsing (.csv) and ```Collection``` instanciation with owned list, wish list and for-sell list. All datas of the spreadsheet are readed for all types of ```Collectibles```. A ```Collection``` is composed of ```Collectible``` which can be ```VideoGame```, ```System```, ```Peripheral```, etc. -Each ```Collectible``` have properties as Title, Type, Platform, etc. - -**Note : This project works on GAMEYE v4.x, development in progress for v5.x.** +Each ```Collectible``` have common properties as Title, Platform, etc. and specific properties as Developer, Publisher, etc. ## Installing @@ -38,14 +36,54 @@ Metacello new load. ``` -## Examples +## How to use it? + +The class ```GameyeExamples``` provide a simple script to load an exported spreadsheet file. +Run ```GameyeExamples loadExportedSpreadsheet``` to test. + +![image](https://github.com/labordep/PharoGameye/assets/49183340/182454b1-4f60-40d9-8e39-3cba2fcc63d1) -To parse an existing exported spreadsheet file run ```GameyeExamples loadExportedSpreadsheet``` example. This example use parsing methods to return three collections : - The "Owned" collection - The "Wish List" collection - The "For Sell" collection +![image](https://github.com/labordep/PharoGameye/assets/49183340/e94ad485-a50c-4a72-b1cd-b22b5b5ef515) + +Then navigate into the model to inspect your collection using the Pharo UI. + +![image](https://github.com/labordep/PharoGameye/assets/49183340/c0046401-56df-4c17-9ac1-04dc1d510611) + +![image](https://github.com/labordep/PharoGameye/assets/49183340/efc8caf7-cd69-473b-bfc5-94c4741e0347) + +## Tips + +### How to get Collectibles with a database synchronization problem ? + +Since v5 of GAMEYE application there is a country / region management. + +A problem can appears when GAMEYE application not recognize your collectible: each collectible is displayed with a "red title". + +You need to fix each collectible by selected the good one in the list, but this is difficult to get all "red title" collectibles, especially on a big database. + +![image](https://github.com/labordep/PharoGameye/assets/49183340/46efd417-f96a-439e-a0fa-dc6e75b23160) + +A way to identify collectibles is to use this script on your collection : + +```smalltalk +"get your collection manually with the sample file" +collection := GameyeCollectionFactory createOwnedCollectionFromExportedSpreadsheet: 'pharo-local\iceberg\labordep\PharoGameye\GameyeSpreadsheetSampleV5.csv' asFileReference. +games := collection videoGamesForCountry: nil. "here games are a list of games with potential problems, no one in the sample" +``` + +Or use ```GameyeExamples``` script to import into the Pharo UI : + +![image](https://github.com/labordep/PharoGameye/assets/49183340/b0a9823b-2415-45fd-be2d-2c1f1c2f1f23) + +![image](https://github.com/labordep/PharoGameye/assets/49183340/f5afd633-59e7-4735-9b3d-cda95c6d04d6) + +Note : this problem was present in v4 but without way to identify wich collectibles are with a problem. + ## About GAMEYE [GAMEYE.app](https://gameye.app/) is a free applicaton to manage collecting from [Harrison Holzhauer](https://www.hdnastudio.com/), © 2016-2023 GAMEYE, INC.